= 

— 

= 

= | | 

© 

> : 

= ® 

<= : Mi 
Oo ® aa 
|" HERR EEEE 
howe = i [Jevnil| 


Tailoring Your Menus 


VM/Integrated System 


om 


SH24-5123-03 


Je. 


Fourth Edition (May 1988) 


This edition, SH24-5123-03, is a major revision of SH24-5123-02, and applies to Version 1, 
Release 5.1 of the VM/Iniegrated System-Productivity Facility (Program 5664-283). This 
edition applies to all subsequent releases until otherwise indicated in new editions. 
Changes are periodically made to the information herein, before using this publication in 
connection with the operation of IBM systems, consult the latest /BM System/370, 30xx, and 
4300 and 9370 Processors Bibliography, GC20-0001, for the editions that are applicable and 
current. 


Summary of Changes 
For a list of changes, see “Summary of Changes” on page 275. 


References in this publication to IBM products, programs, or services do not imply that IBM 
intends to make these available in all countries in which IBM operates. Any reference to 

an IBM licensed program in this publication is not intended to state or imply that only IBM’s 
licensed program may be used. Any functionally equivalent program may be used instead. 


In this manual are illustrations in which names are used. These names are fanciful and 
fictitious, created by the author; they are used solely for illustrative purposes and not for 
identification of any person or company. 


Ordering Publications 


Requests for IBM publications should be made to your IBM representative or to the IBM 
branch office serving your locality. Publications are not stocked at the address given 
below. 


A form for reader’s commenis is provided at the back of this publication. If the form has 
been removed, comments may be addressed to: IBM Corporation, Information 
Development, Dept. G60, P.O. Box 6, Endicott, NY, U.S.A. 13760. IBM may use or distribute 
whatever information you supply in any way it believes appropriate without incurring any 
obligation to you. 


© Copyright International Business Machines Corporation 1985, 1986, 1987, 1988 
IBM is a registered trademark of International Business Machines Corporation, Armonk, 
NY. 


ae ar re 
About This Book 


This book, Tailoring Your Menus, tells you how to tailor the panels of 
VM/Integrated System (VM/IS) to meet the needs of your work 
environment. 


This book also discusses the programming interface for the 
initialization of ISPF. The initialization is a service provided for 
products that use the VM/IS-Productivity Facility. This is the only 
programming interface provided by the VM/IS-Productivity Facility. 
The programming interface information is Covered in 

Appendix B, “Files and Formats” on page 215. 


The VM/IS panels that you tailor are part of a product called the 
VM/Integrated System-Productivity Facility, referred to as the 
Productivity Facility or the PF. The PF panels provide access to the 
products and functions of VM/IS. 


These PF panels can be tailored. You can change the text that 
appears on an existing panel, or create a new panel. You can adda 
new application program to the panels, or delete an existing 
application program. You can add Help or Introductory panels for 
new applications. 


The Productivity Facility paneis illustrated in this book may look 
different than the panels on your system. Your system's panels were 
automatically tailored at the time of installation to reflect the 
products that you ordered. However, the types of panels illustrated 
in this book are the same types of panels that you have on your 
system. 
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Before you start tailoring menus, you should be familiar with the 
menus and know how to use them. This information is available in 
VM/Integrated System Learning to Use Your System: Getting 
Started. See “Related Publications” on page v. 


Who Should Read This Book 


This book contains information about changing the PF panels. It is 
intended for the person who has authority to use the MAINT user ID. 
Information about changing your own Personal menu is found in 
Learning to Use Your System: Getting Started under “Creating a 
VM/IS Panel that Lists Menu Items of Your Choice”. 


To perform the tasks described in this book, you should have a basic 
knowledge of XEDIT and CMS. 


To perform some of the advanced tailoring tasks, you may also need 
knowledge of REXX, EXEC 2, and ISPF. 


What This Book Contains 


This book contains two parts and five appendixes: 


e “Part 1. Basic Tailoring” Shows you how to use the panel-driven 
tailoring facility to customize an existing menu or create a new 
menu. 


e “Part 2. Advanced Tailoring” shows you three tailoring tasks that 
require you to go outside the panel-driven tailoring facility. 
These tasks are adding and packaging an application, adding 
online help, and adding an online introduction topic. 
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e The appendixes contain additional information about the files, 
EXECs, modules, and commands used by the Productivity 
Facility. You may find this information useful during advanced 
tailoring. 
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Conventions Used in This Book 


Convention Meaning 


sample Information you type is shown like this. 
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Related Publications 


The following publications are useful reference for tasks in “Part 1. 
Basic Tailoring”: 


e VM/Integrated System Learning to Use Your System: Getting 
Started, SC24-5343 


e VM/integrated System Managing Your System, SC24-5338 


In addition, the following publications are good reference for VM/IS 
application development: 


¢ VM/Integrated System Developing an Application: Getting 
Started, SC24-5305 


e VM/Integrated System Developing an Application: Related 
Documentation, SC24-5306 


e Virtual Machine/System Product Application Development Guide, 
SC24-5247. 
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Error messages that you may encounter are documented in: 


¢ VM/Integrated System Learning to Use Your System: Error and 
Information Messages, SC24-5351. 


Specific information about commands and macros is found in the 
following publications: 


e VM/Integrated System Writing Simple Programs with REXxX, 
SC24-5357 


¢ Virtual Machine/System Product System Product Editor 
Command and Macro Reference, SC24-5221 


¢ Virtual Machine/System Product System Product Editor User’s 
Guide, SC24-5220 


e Virtual Machine/System Product EXEC 2 Reference, SC24-5219 


e Virtual Machine/System Product System Product Interpreter 
Reference, SC24-5239. 


Specific dialog management information is found in the following 
publications: 


¢ /nteractive System Productivity Facility Dialog Management 
Guide, SC34-4009 


¢ interactive System Productivity Facility Dialog Management 
Services and Examples, SC34-4010 


e /nteractive System Productivity Facility (ISPF) and ISPF/Program 
Development Facility Installation and Customization, SC34-4015 


e Interactive System Productivity Facility/Program Development 
Facility Guide, SC34-4011. 


vi Tailoring Your Menus 


Refer to VM/Integrated System Learning to Use Your System: 
Getting Started, SC24-5343 for ordering instructions and the 
complete list of related publications. 
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Part 1. Basic Tailoring 


The VM/IS panels that you tailor are part of a product called the 
VM/Integrated System-Productivity Facility, referred to as the 
Productivity Facility or the PF. The PF is a group of panels that 
provides an interface to the functions and features of VM/IS. This 
part describes how to use the panel tailoring facility to customize 
your menus. This facility is used to: 


add an item to a menu 

change the wording of items on a menu 
change the order of menu items 

delete an item from a menu 

change the title of a menu 

change the effect that a menu item has 
add a new menu. 


These tasks are described in “Part 1. Basic Tailoring”. 
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The following tailoring tasks are more advanced, and require you to 
go outside the panel tailoring facility: 


e adding and packaging an application 
e adding Help panels 
¢ adding Introduction panels. 


They are described in “Part 2. Advanced Tailoring”. 
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Chapter 1. Introduction to Basic Tailoring 


This chapter introduces the terms and concepts that you must know 
before you can Start basic tailoring. 
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Panel Types 


4 


The Productivity Facility has the following types of panels: 


Long version menus 
Short version menus 
GO menus 


(These menus let you select a function or another menu.) 
Help panels 
Online Introduction panels. 


(These panels give detailed information about functions and 
products that are available on your system.) 


These five types of panels are shown below. 


Figure 1 and Figure 2 show the first page of the Long version and 
the Short version of the LIST menu. (The Long version of the LIST 
menu is five pages; the Short version is two pages.) 
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ESDL220 VM/TS - ALPHABETICAL LIST OF FUNCTIONS Page 1 of 5 
To choose one of the following, type its number and press ENTER: 


AS Application System 
ASF PROFS Applications Support Feature (PROFS ASF). 


Batch Run programs in background. 


CMSNOTE Send CMS notes and messages. 

CSP/AD Develop Cross System Product applications. 

CSP/AE Execute Cross System Product applications. 

Customize Add, modify, move or delete items on the 
personal menu. 


DBEDIT Edit data in a relational data base. 
Create documents using DisplayWrite/370. 


(Continued... Press PF8) 


2. Short 3. End 4 Return 5 CMS 
8 Forward 9 Probrep 10 ... 11 Bottom 12 Retrieve 


Figure 1. The Long Version of the LIST menu 
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ESDS220 VM/TS - ALPHABETICAL LIST OF FUNCTIONS Page 1 of 2 


AS 
ASF 12 Edit NMF 


Batch 13 Files Password 
PDF 
CMSNOTE 14 GDDM PRINT3812 
CSP/AD 15 GO Printfile 
CSP/AE Probman 
Customize 16 Introduction Probrep 
17 ISQL PROFS 
DBEDIT PROFSDOC 
DW370 Library PROFSMAIL 
10 DXT PROFSNOTE 
11 DXTADMIN 
(Continued... Press PF8) 


Return 


Figure 2. The Short Version of the LIST menu 


The Short versions of the home panels display the same key phrases 
as the Long versions and provide access to the same applications. 
The Short versions of the home panels give no description for the 
key phrases. 
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Figure 3 shows a page of the Long version of the GO menu. 
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VM/TS - GO MENU Page 1 of 9 


To choose one of the following, type its number and press ENTER: 


To view more items on this panel, press PF2 (Short). 


1 Tools 
wl Library 
News 
Password 
Probman 
Probrep 
Remote 


2 Personal 
2.1 Main 
2.2 Customize 


Choose from a list of tools and applications. 


Choose from a list of application programs. 
Read the latest news. 

Change your logon password. 

Manage problem reports assigned to you. 
Report problems and view their status. 

Log on to a remote computer system. 


Your own menu that you can customize. 
Go to the Main Menu. 
Add, modify, move or delete items on the 
personal menu. 


(Continued... Press PF8) 


2 Short 4 Return 5 CMS 
8 Forward 9 Probrep 10 ... 11 Bottom 12 Retrieve 


Figure 3. The Long Version of the GO menu 


The GO menu is the menu that you see when you press PF6 (Go) 
from any panel. The GO menu displays selections from the home 
menus in one single list. 
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Figure 4 shows a page of the Help menu for the VM/IS Functions. 


ESDH221 VM/ITS - ALPHABETICAL LIST OF FUNCTIONS: HELP Page 2 of 6 


Help panels for each menu item follow. To read the Helps 
sequentially, press ENTER. To see a specific Help, type the 
number of the menu item on the command l|ine and press ENTER. 


1 AS Application System 
ASF PROFS Applications Support Feature (PROFS ASF). 


Batch Run programs in background. 


CMSNOTE Send CMS notes and messages. 

CSP/AD Develop Cross System Product app:ications. 

CSP/AE Execute Cross System Product applications. 

Customize Add, modify, move or delete items on the 
personal menu. 


DBEDIT Edit data in a relational data base. 
(Continued... Press PF8) 


PF: ite 2 wears 3. End 4 Return 5 CMS 6 Go 
PF: 7 Backward 8 Forward 9 Probrep 10 Top 11 Bottom 12 Retrieve 


===> 


Figure 4. The Help menu Listing the Functions 
The Long, Short, and Help menus are all constructed from the same 


information, and may be thought of as different views of that 
information. 
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Figure 5 shows a page of an Introductory panel for the graphics 
topic. 


ESICGA1O GRAPHICS Page 1 of 2 


What 1s The graphics options provide you with online, 
Graphics? interactive environments for producing color graphs, 
reports, text, and pictures. 


Skill Level No programming experience is required for you to create, 

Required display, or print graphic reports. For the skilled 
programmer, there are advanced graphic facilities available 
on the system. 


Available Choose from the subtopics below to find out more about 


Applications the graphic products available: 


1 GDDM Creating graphic displays. 
2 GDDM/PGF GDDM Presentation Graphics Feature. 


4 Return 5 Skipback 6 Skipforw 
Backward 8 Forward 9 Probrep 10 ... TW way 12 Retrieve 


Figure 5. An Introductory Panel 


The introduction provides a tutorial for new users to learn about the 
PF and the functions that are available from the menus. 
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How the Panel and Menu Types Fit Together 


The following diagrams show how the Long (including Short and Go), 
Help, and Introductory panels fit together. 
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ESDL220 WwvIS - ALPHABET(CAL LIST) OF FUNCTIONS Poge ! of § 


1 AS Uee the App! icotioan stom. 

2 ASF PROFS App! icotlons Support Feature (PROFS ASF). 

3 Saten Run progroma in backgrbund. 

4 QJSNOTE Send G& notas ond meashges. 

5 CSP/AD Develop Cross Syetam Praéduct applications. 

6 CSP/AE Execute Crosse System Pragiuct app! icationg 

7 Customize Add, modify, move or delgte item= on the | 
personal menu. 

6 OBEDIT Edit deta in a ralationa! to bose 

@ Ow370 Create documents using DisbloyWrite/37G 


(Continued... Presa PFB) 


Help 2 Snort 3 End 4 Return 5 OG 6 Go 
: 8 Forwar Probrap 10 1! Bottom 12 Retrieve 


HELP 


—{sHorT|— — 


VWW/IS - ALPHABETICAL LIST OF FUNCTIONS Page 1 of 2 


“ 


| 4 
§ SOH2?1 W4/ 1S - ALPHABEJ ICAL LIS? OF FUNCTIONS: HELP Ne 


Help ponels far each Ta choose on 
gequentio)iy. press 


number of the manu j 1 AS 
2 ASF 1Z Eait 70 NMF 
1 AS ge the Appilcation System XN 
2 ASF FS App! ications Support Feature (PROFS ASF} Se 3 Batch 13 Files 21 Posaword 
22 POF 
3 Beter un programa in bockground be 4 OVGNOTE 14 GOOM 25 PRINTI612 
5 CSP/aD 15 GO 24 Printfite 
4 OMGNOTE nd OVS notes ond messcges NS 6 CSP/AE 25 Probmon 
5 CSP/AD velop Crosse Syatam Product app! icotionn i, 7 Customize 16 Introductian 26 Probrep 
& CSP/AE Eeocute Crome System Product opp! ications “Nn 17 1SOL 27 PROFS 
? Customize id, modify. move or delete items on the 8 OBEDIT 28 PROFSDOC 
Sey sana! menu g 18 Liprary 29 PROFSMAI{ 
10 30 PROF SNOTE 
4 OBEDIT Eat data no retotiona! dota boss Sent 10 Moin 
(Cont inued Prems PFA) \ (Cont .nued Press PFB) 
PF 2 3. Ene 4 Return 5 OS 6 Go 3 Ena 4 Return 5 A6& 6 Go 
PF 7 Bockwerd B Forword 9 Prebepiid Top 11 Bottom 12 Retrieve 7 8 Forward 9 Probrep 10 1] Bottom 12 Retrieve 
\ ca ee 
-——=<> seis —_ — 


On any VM/IS menu, you can press PF2 to switch between the Long 
version and the Short version of the menu. From either version of 
the menu, you can press PF1 to go to a Help panel. 
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1 Toots 
1 1 Library 
12 News 
1 3) Possworo 
4 Probron 


' 5 Probraep 


2 Persona! 
2.1 Main 
2.2 Customiz 
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| MAIN -__| eae 
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To choose one of the following, type 


\ 1 Toole Choose froma liut of tools and applications 
| 2 Persona Your own menu that you can customize 
{ 3 Office Perform adminiatration ond communication tasks 
j 4 Document Work with dacuments 
5 Printers Print files 
6 Program Computer pragramming. 
7? Databosa Stora and retrieve data 
6 Gropnics Produce graphs 
8 Wraske Work with CWS files and syatem resources 
10 List Choose from an olphabatical list of W/IS functians 
11 Introduction Reod adout VW/IS functions 
12 GO Make option selections using a shortcut 


MAIN MENU 


itm number ond press ENTER: 


Choose froma list of 


Choose fram a jiat of application programs 
Reod the ‘ctest nawa 

Cronge your |ogon posaworda 

Monage probiem reports assignes to you 
Nepor! probiems ond view their atctue 


Your own menu thet you con custom! ze 
Go to the Moin Man 
modify, Tove of delete ‘t 


e Adc 
versana! manu 


2 Short 3 tnd 
8 Forword 9 Probrep 


prees PF2 (Short! 


tools and app! : cations 


About thie introduct,or 

Using the WW/{S-Productivity Facility teotures 
Cnoose froma /iat of tools and applicotions 
Introduction to Application Systen 

Your own menu thot you con customize 


6 Office Performing Office Tonks 


7 Document Creeting docurents 


_______|INTRODUCTION PANEL| 


Page |! of 2 


(Cont +nued Press PFA) 
| 2 S End 4 Return 5 6 
} PF ? 6 Forward 9 Probrep 10 1! Bottom 12 Retr: ave 


On the MAIN menu, there are two special selections. If you select 
11, you go to an Introduction Topics panel. If you select 12, you go to 
the GO menu. There is only one GO menu. It is built automatically 
from information provided by the other panels. You should tailor 
only the title, preface, and running header on the GO menu. 
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Parts of a Menu That Can Be Tailored 


The highlighted parts of the following menu can be tailored using the 
basic tailoring procedures: 


ESDL190 VM/IS - PERSONAL MENU 


To choose one of the following, type its number and press ENTER: 


1 Main Go to the Main Menu. 


2 Customize Add, modify, move or delete items on the 
personal menu. 


2 Short 3. End 4 Return 5 CMS 
a wae 9 Probrep 10 ... Ll: end 12 Retrieve 


Figure 6. The PERSONAL menu Showing Tailorable Parts 


The following parts can be tailored: 
1. The title line: 
VM/ITS - PERSONAL MENU 
The title line is the first line of text to appear on a panel. 
2. The running header: 


To choose one of the following, type its number and press ENTER: 
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The running header is a block of text that appears immediately 
below the top line of dashes. 


. The key phrases for selectable items: 


Main 
Customize 


Selectable items are optional. Each selectable item has a key 
ohrase and a block of description lines. 


The key phrase is preceded by a selection number that is 
automatically generated for you. 


. The description lines for selectable items: 


Go to the Main Menu. 
Add, modify, move or delete items on the personal menu. 


Each description line is positioned to the right of its key phrase. 


ee Ti ee a a a 
Which Menus Can Be Tailored 


VM/IS consists of the VM/IS BASE and the following optional 
packages: 


The Engineering/Scientific Program Development Support 
(E/SPDS) package 


The Text/Office System (TXTO) package 

The Data Base Query (DBQ) package 

The Remote Communication Support (RCS) package 
The Transaction Processing (TXN) package 

The Application Development Support (ADS) package 
The Networking Support (NTWK) package 

The Intelligent Workstation Support (IWS) package 
The Support Services (SS) package. 
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Your menus may look slightly different, depending on which optional 
packages you ordered. The examples in this book assume you have 
all the packages installed. 


In the “Basic Tailoring” section, you learn how to tailor the menus 
that are listed on the Customization menu. (You learn how to tailor 
other panels in the “Advanced Tailoring” section.) In the basic 
tailoring section, the user of the MAINT user ID can tailor the 
following menus: 


. MAIN menu 

. PERSONAL menu 
. OFFICE menu 

. DOCUMENT menu 
. PRINTERS menu 

. PROGRAM menu 
. DATABASE menu 
. GRAPHICS menu 
. TOOLS menu 

. LIST menu. 
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The MAINT user can also create a new menu. 


You cannot use basic tailoring procedures to tailor the following 
menus: 


1. VMTASKS menu 
2. CUSTOMIZATION menu. 


and cannot directly tailor the Introduction and Help panels. 


Note: The GO, CUSTOMIZATION, HELP, and SYSTEM panels are 
automatically updated to reflect changes made to the tailored 
menus. 
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A general user can tailor only his or her own PERSONAL menu, as 
described in VM/Integrated System Learning to Use Your System: 
Getting Started. 


Each panel has a unique panel identifier. To help you follow the 
panel flow, the examples in this book show the panel identifier in the 
upper left corner of the panel. If you want panel identifiers to appear 
on your panels, type panelid onon the command line of any panel. 
Type panelid off to turn them off again. 
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Tailoring Your Menus 


Chapter 2. Customizing an Existing Menu 


This chapter shows you how to make simple changes to your PF 
menus. 


This chapter discusses: 


Adding a selectable item 

Moving an item (changing the order of menu items) 
Changing an item's key phrase, description, or effect 
Deleting and Undeleting an item 

Changing a menu title 

Changing a running header 

Adding a header. 


Chapter 2. Customizing an Existing Menu 


This chapter contains customization examples for menus listed on 
the CUSTOMIZATION menu. If you want to customize a menu that is 
not listed on the CUSTOMIZATION menu (such as Introduction or 
Help panels), follow the instructions in “Part 2. Advanced Tailoring” 
on page 113. 


The Starting Point 


Each of the examples in this chapter starts with you logged onto the 
MAINT user ID and looking at the SYSTEM menu. To go to the 
SYSTEM menu, type: 


pf 


on the command line, and press ENTER. 


Each example in this chapter assumes that you have already done 
the previous examples. If you have not done the previous examples, 
you may see slightly different panels. 


When you do the examples in this chapter, files are created on 
MAINT’s 191 (A) minidisk. (If you prefer, you can use the Diskmode 
PF key to send the files to a different minidisk.) When you have 
finished customizing, you can copy these files to the 322 (O) 
minidisk, as described in Chapter 4, “Making New and Customized 
Menus Part of Your System” on page 109. 
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Adding an Item to Your Menu 


In this example, you add a new selection and an existing selection 
to the PERSONAL menu. An existing selection already exists on at 
least one of the menus shipped with the PF. A new selection is an 


item you create and add. You start from the SYSTEM menu. 


ETULOQ10 VM/TS - SYSTEM MENU 
To choose one of the following, type its number and press ENTER: 


1 EndUser Invoke the End-User Main Menu 

2 Customization Invoke the Customization Menu. 
3 New-Menu Create a new menu. 

4 Maintenance Invoke VM/SP Maintenance tasks. 


(C) COPYRIGHT IBM CORP 1988 


2 Short 3. End 4 Return 5 CMS 
Oo #es 9 Probrep 10 ... ee 12 Retrieve 


Figure 7. The SYSTEM menu 


1. To go to the CUSTOMIZATION menu, type: 
2 


on the command line, and press ENTER. 
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ETUL120 VM/IS - CUSTOMIZATION MENU 


To customize one of the following, type its number and press ENTER: 


Main-menu 
Too! s-menu 
Personal -menu 
Office-menu 
Document-menu 
Printers-menu 
Program-menu 
Database-menu 
Graphics-menu 
List-menu 


Owo Omn7 nm FP WNP 


—_ 


PF: 1 Help 2 Short 3 End 4 Return 5 CMS 6 Go 
PRE 2 sae Oke 9 Probrep 10 ... I wey 12 Retrieve 


Figure 8. The CUSTOMIZATION menu 


2. You select the menu you wish to customize from this menu. In 
this example, you customize (edit) the PERSONAL menu. To edit 
the PERSONAL menu, type: 


2 
) 


on the command line, and press ENTER. 
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nm 
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ESDEDIT 


Enter commands in the left column. Press PF2 for a command list. 


_ To choose one of the following, type its number and press ENTER: 
1 Main Go to the Main Menu. 


2 Customize Add, modify, move or delete items on the 
personal menu. 


PF: 1 Help 2 Edit Cmds 3 Save/Exit 4... 5 Diskmode’ 6 Go 
a ae ——e O Probrep 10 ... tarry Ie: 8 


Figure 9. The Editing panel 


You see the EDITING A MENU panel. Note that the EDITING A 
MENU panel is not a menu and it will be referred to as the Editing 
panel. 


This panel displays the tailorable items of the menu that you are 
customizing. Note that the PF key settings apply to the Editing 
panel that you are on now, not to the menu that you are editing. 
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3. Press PF2 (Edit Cmds) to see a list of the editing commands that 
you Can use: 


ESDEDIT EDITING A MENU Menu Item (1 ) of 2 


Enter commands in the left column. Press PF2 for a command list. 


- a a a ae ae 
-------------------------------- Type the following commands to the left 
_ To choose one of the following of the line you want to edit: 
= 1 Main Go to COMMANDS DESCRIPTION 
7 E (Edit) edit a line 
= 2 Customize Add, m | A (Add) add a line 
person | M (Move) move an line 

F (Following) move following 

D (Delete) delete a line 

U (Undelete) recover deleted items 

| PFl Help PF3/12 Cancel 

PF: 1 Help 2 Edit Cmds 3 Save/Exit 4... 5 Diskmode 6 Go 
OPS gas —_— 9 Probrep 10... ik ere le ans 


Figure i0. The Editor Command window 


Note that the editing commands appear in a window of the 
Editing panel. Windows appear on top of the current screen. lf 
you have two windows at once, one may overlap the other. 


4. Press PF12 (Cancel) to leave the window. 
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5. Press PF3 (Save/Exit) to display the Save/Exit window, as shown 
below: 


ESDEDIT 


Enter commands in the left column. Press PF2 for a command list. 


Place the cursor to the left of 
2 Customi your choice and press Enter: tems on the 
Save Changes and Exit 
Exit Without Saving 
Resume editing 


2 Edit Cmds 3 Save/Exit 4... 5 Diskmode 6 Go 
Dead 9 Probrep 10... TL mac Le ges 


Figure 11. The Save/Exit window 
The PF key settings displayed in the window apply to the window, 
not to the Editing panel. 


6. Press PF12 (Cancel) to close the window and return to the Editing 
panel. 


Note: To close the window and resume editing, you could press 
PF3, press PF12, or move the cursor opposite Resume 
editing and press ENTER. 
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ESDEDIT EDITING A MENU Menu Item (1 ) of 2 


Enter commands in the left column. Press PF2 for a command list. 


meee eee ew we we ee ew ee Bem ee BP eee we we Be ew ew ew ew ee eM eM ee ewe ew eM ew eee ew eM ew ee ee eB ew eM ewe ew ee ew ew ew ew ewe ee 


_ To choose one of the following, type its number and press ENTER: 
1 Main Go to the Main Menu. 


2 Customize Add, modify, move or delete items on the 
personal menu. 


Ip 2 Edit Cmds 3 Save/Exit 4... 5 Diskmode 6 Go 
_—— 9 Probrep 10... Te eo ae 


Figure 12. The Editing panel 


7. The first key phrase that you add to the PERSONAL menu is the 


command FILELIST. To add this command, type: 


d 


in the prefix area beside item 2, as shown below. All editing 


commands are entered in the prefix area. 
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ESDEDIT 


_ To choose one of the following, type its number and press ENTER: 


1 Main Go to the Main Menu. 


2 Customize Add, modify, move or delete items on the 
personal menu. 


2 Edit Cmds 3 Save/Exit 4... 5 Diskmode 6 Go 
O64 9 Probrep 10 .«. TT 22 We pte 


Figure 13. The Editing panel 


Press ENTER. A new line appears below item 2. 


Chapter 2. Customizing an Existing Menu 


25 


26 


ESDEDIT 


Enter commands in the left column. Press PF2 for a command list. 


_ To choose one of the following, type its number and press ENTER: 


1 Main Go to the Main Menu. 


2 Customize Add, modify, move or delete items on the 
personal menu. 


2 Edit Cmds 3 Save/Exit 4... 5 Diskmode 
Ogee 9 Probrep 10... i eee 


Figure 14. The New Prefix Area 


8. Type: 


e 
in the prefix area of the new line, to edit the new line. 
Press ENTER. The Key Phrase window appears. 


A key phrase is the single word used on a menu to describe a 
function. On the Key Phrase window, you specify the command 
that will be executed when the key phrase is selected. 
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9. Type the information in the Key Phrase window as shown below: 


ESDEDIT 


Enter commands in the left column. Press PF2 for a command list. 


To choose one of the following, type its number and press ENTER: 


1 Main Go to the Main Menu. 
2 Customize Add, modify, move or delete items on the 
personal menu. 
E 
Key Phrase ( FILELIST ) 
Description ( Display a list of files on your A-disk. ) 
( ) 
Command ( exec filelist ) 


Does the command need ISPF (Y/N)?( N ) 


PFl Help PF2 Keep Changes PF5 Pick Key Phrases PF3/12 Cancel 


Figure 15. The Key Phrase window 


Filelist is one of the commands available on your system. To 
learn more about the commands that you can add to your menus, 
refer to Virtual Machine/ System Product System Product Editor 
Command and Macro Reference, SC24-5221. You can also use 
EXECs that you have created. 


Note: The VM/IS-Productivity Facility allows you to start ISPF 
before starting the program or application named in the 
“KEY PHRASE field. This is provided as a programming 
interface. To specify the initialization of ISPF, type y in the 
Does the command need ISPF? field. For more details on this 
programming interface see the description of “COMMAND 
in the content item file section of “Content Item Files” on 
page 244. 
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Press PF2 (Keep Changes). The Key Phrase window disappears 
and the new item appears on the Editing panel. 


ESDEDIT EDITING A MENU Menu Item (1 ) of 3 


Enter commands in the left column. Press PF2 for a command list. 


_ To choose one of the following, type its number and press ENTER: 


1 Main Go to the Main Menu. 
2 Customize Add, modify, move or delete items on the 
personal menu. 
3 FILELES? Display a list of files on your A-disk. 
PF: 1 Help 2 Edit Cmds 3 Save/Exit 4... 5 Diskmode 6 Go 
PFt fF wes wack 9 Probrep 10... LD, sec rr 


Figure 16. The Editing panel 


10. The second item that you add is the Password selection. 


Password already appears on the LIST panel. Since Password is 
a key phrase reserved by the PF, you can transfer it and its 
associated commands. You do not need to remember or retype 
this information. 


Type: 


d 


beside item 3 and press ENTER. A new line appears. 
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BEBEeSeaeBaeaBEA a BR 


BE B 
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11. In the new prefix area below item 3, type: 
e 


Press ENTER. The Key Phrase window appears again. 


ESDEDIT 

Enter commands in the left column. Press PF2 for a command list. 
Key Phrase 
Description 


Command ( 
Does the command need ISPF (Y/N)?( N ) 


PF1 Help PF2 Keep Changes PF5 Pick Key Phrases PF3/12 Cancel 


2 Edit Cmds 3 Save/Exit 4... 5 Diskmode 
ee 9 Probrep 10... iG ewer 


Figure 17. The Key Phrase window 


12. Press PF5 (Pick Key Phrases). The Pick a Key Phrase window 
appears. 
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ESDEDIT 
Enter commands in the left column. Press PF2 for a command list. 


Place the cursor on the reserved setection item you 
Key Phrase want on your menu, and press Enter. 
Description 


ASF CMSNOTE CSP/AD 
Command ( CSP/AE Database DBEDIT 
Does the comma Document DW370 DXT 

DXTADMIN Edit Files 

GDDM GO Graphics 


Introduction ISQL Library 
List Main News 

NMF Office Password 
PDF Personal Printers 
Printfile Probman Probrep 


: 1 Help 2 Edit Cmds 3 Save/Exit 4... 5 Diskmode 
ee Q9 Probrep 10... My wee 


Figure 18. The Pick a Key Phrase window 


13. Move your cursor to the item Password, and press ENTER. 
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Bpenmeneeereen es 


= 


a 


| 


Be 


14. The Pick a Key Phrase window disappears and the Key Phrase 


window is automatically filled in with the required information, as 


shown below: 


ESDEDIT EDITING A MENU Menu Item (1 ) of 4 


Enter commands in the left column. Press PF2 for a command list. 


weet ee ew ee ew em ew eB eB eB eB eB eB eB eB ew ee ee ew eM eB ee ew ew eM Bw em eB BP em ew ew em eB eB eM eB eM eB ee ew ew ew ew eB eB eB ew ew ew ew eB ew em ew Bw eee ew ew ew ee em ee 


Key Phrase ( Password ) 
Description ( Change your logon password. ) 
( ) 
Command ( EXEC ESAPW ) 
Does the command need ISPF (Y/N)?( N ) 
PFl Help PF2 Keep Changes PF5 Pick Key Phrases PF3/12 Cancel 
E 4 Password Change your logon password. 
PF: 1 Help 2 Edit Cmds 3 Save/Exit 4... 5 Diskmode 6 Go 
PES oF. cage ae 9 Probrep 10... Ll aes 12 aes 
ESAEDO24 You may look at or delete this item but not change it. 
ss 2> 


Figure 19. The Key Phrase window 


The items in the window are reserved items. When you choose 


one of these items as a selectable item for a menu, you see 
message ESAEDO24. None of these items can be changed. 


Press PF2 (Keep Changes). The Key Phrase window disappears 


and the Password selection appears on the Editing panel. 
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ESDEDIT 


Enter commands in the left column. Press PF2 for a command list. 


_ To choose one of the following, type its number and press ENTER: 


1 Main Go to the Main Menu. 


2 Customize Add, modify, move or delete items on the 
personal menu. 

3 FeLELIST Display a list of files on your A-disk. 

4 Password Change your logon password. 


2 Edit Cmds 3 Save/Exit 4... 5 Diskmode 6 Go 


ae 9 Probrep 10... eee | ee 


Figure 20. The Editing panel 


15. To add blank lines, type: 


q 


in the prefix areas, as shown below: 
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BRS SBSBeSBSeBeHEeaAaEeaaSa B 


ESDEDIT 


Enter commands in the left column. Press PF2 for a command list. 


_ To choose one of the following, type its number and press ENTER: 


1 Main Go to the Main Menu. 
2 Customize Add, modify, move or delete items on the 
personal menu. 


3 FILELISI Display a list of files on your A-disk. 
4 Password Change your logon password. 


2 Edit Cmds 3 Save/Exit 4... 5 Diskmode 6 Go 
Cr atew 9 Probrep TO say eS ae 12... 


Figure 21. The Editing panel 


Press ENTER. Blank lines appear between items 2 and 3, and 
items 3 and 4: 
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ESDEDIT 


Enter commands in the left column. Press PF2 for a command list. 


_ To choose one of the following, type its number and press ENTER: 


1 Main Go to the Main Menu. 


2 Customize Add, modify, move or delete items on the 
personal menu. 


_ 3 FLLELIST Display a list of files on your A-disk. 

- 4 Password Change your logon password. 

PF: 1 Help 2 Edit Cmds 3 Save/Exit 4... 5 Diskmode’ 6 Go 
Pre as o .255 9 Probrep 10... TT ene le. Saw 


Figure 22. The Editing panel 


16. Press PF3 (Save/Exit) to save your changes and exit the editing 


session. The Save/Exit window appears. 
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nm mH 


BaHRSE BBEeBEeBEeEHEeaBEaEaA SB BSB 


ESDEDIT 


Enter commands in the left column. 


2 Customi 


3 FILELIS 


4 Passwor 


Place the cursor to the left of 
your choice and press Enter: 
Save Changes and Exit 
Exit Without Saving 
Resume editing 


2 Edit Cmds 3 Save/Exit 4... 


Dabs 


9 Probrep 10 ws. 


Figure 23. The Save/Exit window 


Press PF2 for a command list. 


tems on the 


ur A-disk. 


5 Diskmode 6 Go 
Vd. eee Te? asd. 


17. With your cursor beside the Save Changes and Exit selection, press 
ENTER. There is a pause while the menus are filed, then the 
CUSTOMIZATION menu appears again. 


18. Press PF3 (End) to return to the SYSTEM menu. 


You have completed the “adding menu items” example. 


Testing Your Menus 


1. To test the customized PERSONAL menu, choose panels and 
selections as shown below: 
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THE MAIN PERSONAL 
SYSTEM MENU MENU 
MENU 
— —_|—» 
Choose: Choose: 
EndUser Personal 
| 


The PERSONAL menu should look like this: 


ESDL190 VM/TS - PERSONAL MENU 


To choose one of the following, type its number and press ENTER: 


1 Main Go to the Main Menu. 


2 Customize Add, modify, move or delete items on the 
personal menu. 


oF ELELTS) Display a list of files on your A-disk. 


4 Password Change your logon password. 


3. End 4 Return 5 CMS 
8... 9 Probrep 10 ... ll... 12 Retrieve 


Figure 24. The PERSONAL menu 


On this menu, you can select 3to see a filelist, or 4to change 
your password. 


2. Press PF4 (Return) to return to the SYSTEM menu. 


This customized PERSONAL menu Is used in the next example. 
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Moving an Item (Changing the Order of Menu Items) 


In this example, you change the order of the menu items on the 
PERSONAL menu. 


1. To edit the PERSONAL menu, choose panels as shown below: 


THE 
SYSTEM 
MENU 


CUSTOMIZATION 
MENU 


Choose: 
Personal -menu 


Choose: 


Customization See below 


2. To move item 2 following item 4, type: 


m 


and 
f 


in the prefix areas, as shown below: 
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ESDEDIT 


Enter commands in the left column. Press PF2 for a command list. 


_ To choose one of the following, type its number and press ENTER: 


1 Main Go to the Main Menu. 


2 Customize Add, modify, move or delete items on the 
personal menu. 


So FILELIS! Display a list of files on your A-disk. 


4 Password Change your logon password. 


2 Edit Cmds 3 Save/Exit 4... 5 Diskmode 6 Go 
o se 9 Probrep 10... 1 ee | eee 


Figure 25. The Editing panel 


Press ENTER. The Customize item moves below the Password 
item, and the numbering sequence changes automatically. 


3. To move a blank line between items 3 and 4, type: 


m 


and 


£ 
1 


in the prefix areas, as shown below: 
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re 


ESDEDIT 


Enter commands in the left column. Press PF2 for a command list. 


_ To choose one of the following, type its number and press ENTER: 


1 Main Go to the Main Menu. 


2 FAMERS Display a list of files on your A-disk. 


3 Password Change your logon password. 
4 Customize Add, modify, move or delete items on the 
personal menu. 


2 Edit Cmds 3 Save/Exit 4... 5 Diskmode 
Bo vas 9 Probrep 10... Ti. ses 


Figure 26. The Editing panel 


Press ENTER. The blank line moves below the Password item. 


4. Press PF3 (Save/Exit) to save your changes and exit the editing 
session. The Save/Exit window appears. 
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ESDEDIT 


Enter commands in the left column. Press PF2 for a command list. 


weer nee ew Hwee wwe ee wwe ewe ew ew ee ee ee ew ew eB ee ee ew ew ee oe wee eB we ew ww em eee ew ew ew ew ew ee eB ew ee ee eee ee 


1 Main 9 ------------------------------------ 
Place the cursor to the left of 
2 FILELIS | your choice and press Enter: ur A-disk. 
Save Changes and Exit 
3 Passwor Exit Without Saving 
Resume editing 
4 Customi | ---------------------------------- tems on the 
PFl Help PF3/12 Cancel 
PF: 1 Help 2 Edit Cmds 3 Save/Exit 4... 5 Diskmode 6 Go 
PFt- 7 eas ee 9 Probrep 10... 1k sae 12> dine 


Figure 27. The Save/Exit window 


5. With your cursor beside the Save Changes and Exit selection, press 
ENTER. There is a pause while the menus are filed, then the 
CUSTOMIZATION menu appears again. 


6. Press PF3 (End) to return to the SYSTEM menu. 


You have completed the “moving menu items” example. 
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To test the customized PERSONAL menu, choose panels as shown 


below: 


THe 
SYSTEM 
MENU 


PERSONAL 
MENU 


Choose: Choose: 
EndUser Personal 


The PERSONAL menu should look like this: 


ESDL190 VM/IS - PERSONAL MENU 
To choose one of the following, type its number and press ENTER: 
1 Main Go to the Main Menu. 
2 FILELIST Display a list of files on your A-disk. 
3 Password Change your logon password. 


4 Customize Add, modify, move or delete items on the 
personal menu. 


2 Short 3. End 4 Return 5 CMS 
Saad 9 Probrep 10 ... i ere 12 Retrieve 


Figure 28. The PERSONAL menu 


Press PF4 (Return) to return to the SYSTEM menu. 
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[ee aa REE, SEED eS oe i a a TO PS Oe a PSE 
Changing a Selectable Item 


You can view, but not change, items that you added to a menu from 
the Pick-a-Key Phrase window. 


You can change the key phrase, description, or command of any 
other item that you added to a menu. 


In this example, you make changes to the FILELIST item on the 
PERSONAL menu. It is the first item that you added in the “Adding 
an Item to Your Menu” section. 


1. To edit the PERSONAL menu, choose panels as shown below: 


THE | CUSTOMIZATION EDITING 
SYSTEM MENU PANEL 
MENU 

+ ———> 


Choose: Choose: 


Customization Personal -menu See below 


2. To edit the FILELIST item, type: 


e 


in the prefix area, as shown below: 
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L. Lb. 


7 


BHeEeHlSE B 


ee ee ee ee 


ESDEDIT 


Enter commands in the left column. Press PF2 for a command list. 


_ To choose one of the following, type its number and press ENTER: 
1 Main Go to the Main Menu. 
2 FILELIST Display a list of files on your A-disk. 
3 Password Change your logon password. 


4 Customize Add, modify, move or delete items on the 
personal menu. 


PF: 1 Help 2 Edit Cmds 3 Save/Exit 4... 5 Diskmode 
OC eis 9 Probrep 10... Tacs 


Figure 29. The Editing panel 


Press ENTER. The Key Phrase window appears. 
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ESDEDIT 


Enter commands in the left column. Press PF2 for a command list. 


To choose one of the following, type its number and press ENTER: 


1 Main Go to the Main Menu. 
E 2 FILELIST Display a list of files on your A-disk. 
| Key Phrase ( FILELIST es 
Description ( Display a list of files on your A-disk. ) 
Command exec filelist 


Does the command need ISPF (Y/N)?( N ) 


eee ent ee ew we ee He kee me ee ee BP ewe ew Be eB BP ee we ewe BP ew MP MP ew ew eM MP ee BP ew we wm mw ee ew ee ew ew ee ee ew ee ew ew ee ee 


PF1 Help PF2 Keep Changes PF5 Pick Key Phrases PF3/12 Cancel 


PF: 1 Help 2 Edit Cmds 3 Save/Exit 4... 5 Diskmode 6 Go 
PRS 7 wax ee 9 Probrep 10... 1 nes Pe ass 


Figure 30. The Key Phrase window 


3. To change the key phrase, type: 


File list 


over FILELIST, and type: 


Invokes filelist 


over Display a list of files In the window, as shown below: 
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BpHReEeSBSSEeaeEsegpBeHEeeHReAEeBEeE aS BS 
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ESDEDIT 


Enter commands in the left column. Press PF2 for a command list. 


To choose one of the following, type its number and press ENTER: 


1 Main 


Go to the Main Menu. 


E 2 FILELIST Display a list of files on your A-disk. 
Key Phrase (Filelist ) 
Description ( Invokes filelist on your A-disk. ) 
( ) 
Command ( exec filelist ) 
Does the command need ISPF (Y/N)?( N ) 
PFl Help PF2 Keep Changes PF5 Pick Key Phrases PF3/12 Cancel 
PF: 1 Help 2 Edit Cmds 3 Save/Exit 4... 5 Diskmode 6 Go 
PFS 2 wee Oo S20 9 Probrep 1) sas TA. seas Ie ea 
eee 
— 


Figure 31. The Key Phrase window 


Press PF2 (Keep Changes). The Key Phrase window disappears, 
and the changes appear, as shown below: 
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ESDEDIT 


Enter commands in the left column. Press PF2 for a command list. 


_ To choose one of the following, type its number and press ENTER: 


1 Main Go to the Main Menu. 
2 Filelist Invokes filelist on your A-disk. 
3 Password Change your logon password. 


4 Customize Add, modify, move or delete items on the 
personal menu. 


2 Edit Cmds 3 Save/Exit 4... 5 Diskmode 6 Go 
a 9 Probrep 10... il) eee le sex 


Figure 32. The Editing panel 


4. Press PF3 (Save/Exit) to Save your changes and exit the editing 
session. The Save/Exit window appears. 
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BPHRESBEeEBEERBEEHEeESEEBEEHEeSBEaEHAa BSB 


ESDEDIT 


Enter commands in the left column. Press PF2 for a command list. 


Place the cursor to the left of 
2 Filelis | your choice and press Enter: 
Save Changes and Exit 
3 Passwor Exit Without Saving 
Resume editing 
4 Customi tems on the 


2 Edit Cmds 3 Save/Exit 4... 5 Diskmode 
Os 2-64 9 Probrep 10... Il, eats 


Figure 33. The Save/Exit window 


5. With your cursor beside the Save Changes and Exit selection, press 


ENTER. There is a pause while the menus are filed, then the 
CUSTOMIZATION menu appears again. 


6. Press PF3 (End) to return to the SYSTEM menu. 


You have completed the “change menu items” example. 
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To test the changed item on the PERSONAL menu, choose panels as 
shown below: 


THE MAIN PERSONAL 
SYSTEM MENU MENU 


The PERSONAL menu should look like this: 


ESDL190 VM/IS - PERSONAL MENU 


To choose one of the following, type its number and press ENTER: 


1 Main Go to the Main Menu. | 
2 Filelist Invokes filelist on your A-disk. | 
3 Password Change your logon password. 

4 Customize Add, modify, move or delete items on the 


personal menu. 


PF: 1 Help 2. shert 3. End 4 Return 5 CMS 6 Go 
PE oe etre C wax 9 Probrep 10 ... ik er 12 Retrieve 


Figure 34. The PERSONAL menu 


Press PF4 (Return) to return to the SYSTEM menu. 
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Deleting or Undeleting an Item 


You can delete items from any of the menus shown on the 
Customization menu. You can also ‘undelete’ items that you have 
deleted during the current editing session. 


In this example, you delete two items and the blank line between 
them from the PERSONAL menu. 


1. To edit the PERSONAL menu, choose panels as shown below: 


THE CUSTOMIZATION EDITING ] 
SYSTEM MENU PANEL 

MENU 

| hate 

Choose: Choose; 

Customization Personal -menu See below 


2. To delete items 2 and 3 and the blank line between them, type: 
d 


in the prefix areas, as shown below: 
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ESDEDIT 


Enter commands in the left column. Press PF2 for a command list. 


_ To choose one of the following, type its number and press ENTER: 


1 Main Go to the Main Menu. 
2 Filelist Invokes filelist on your A-disk. 
3 Password Change your logon password. 


4 Customize Add, modify, move or delete items on the 
personal menu. 


2 Edit Cmds 3 Save/Exit 4... 5 Diskmode 6 Go 
OB sais 9 Probrep 10... Oh cas IZ: wa 


Figure 35. The Editing panel 


Press ENTER. The Filelist and Password items are deleted. 
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Enter commands in the left column. Press PF2 for a command jist. 


_ To choose one of the following, type its number and press ENTER: 


1 Main Go to the Main Menu. 


2 Customize Add, modify, move or delete items on the 
personal menu. 


2 Edit Cmds 3 Save/Exit 4... 5 Diskmode 6 Go 
GO ses 9 Probrep 10... TD cave 1? aes 


Figure 36. The Editing panel 
Note: To return deleted items using the undelete editing option, 
you must remain on the Editing panel. 


3. To see the deleted items and return the Filelist item to the menu, 
type: 


u 


in the prefix area, as shown below: 
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De 


\ 


ESDEDIT 


Enter commands in the left column. Press PF2 for a command 11 


_ To choose one of the following, type its number and press ENTER: 


1 Main Go to the Main Menu. 


2 Customize Add, modify, move or delete items on the 
personal] menu. 


PF: 1 Help 2 Edit Cmds 3 Save/Exit 4... 5 Diskmode' 6 Go 
PFS 2 was Osea 9 Probrep 10... | or Le woes 


Figure 37. The Editing panel 


Press ENTER. The Undelete window appears, and the last item 


deleted, in this case the Password item, appears in the window. 
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4. Press ENTER to view the next deleted item. The Filelist item 
appears, as shown below: 


ESDEDIT EDITING A MENU Menu Item ( 1 


Enter commands in the left column. Press PF2 for a command list. 


To choose one of the following, type its number and press ENTER: 
1 Main Go to the Main Menu. 
2 Filelist Display a list of files on your A-disk. 


Press ENTER to view the next deleted item. 
Press PF2 to undelete (recover) the current item. 


Filelist Invokes filelist on your A-disk. 


ENTER PF1 Help PF2 Undelete PF3/12 Cancel 


2 Edit Cmds 3 Save/Exit 4... 5 Diskmode 
D. acess 9 Probrep 10... i nee 


Figure 38. The Undelete window 


5. Press PF2 (Undelete). The Undelete window disappears, and the 
Filelist item appears again, as shown below: 
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ESDEDIT EDITING A MENU Menu Item ( 1 ) of 3 


Enter commands in the left column. Press PF2 for a command list. 


_ To choose one of the following, type its number and press ENTER: 
1 Main Go to the Main Menu. 
2 Filelist Invokes filelist on your A-disk. 


3 Customize Add, modify, move or delete items on the 
personal menu. 


2 Edit Cmds 3 Save/Exit 4... 5 Diskmode 
Beats 9 Probrep 10... Tl ace 


Figure 39. The Editing panel 


6. Type: 


U 


in the prefix area of the blank line, as shown below: 
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BREeEBESBSSEEaBSa B 


ESDEDIT 


Enter commands in the left column. Press PF2 for a command list. 


_ To choose one of the following, type its number and press ENTER: 


1 Main Go to the Main Menu. 
2 Filelist Invokes filelist on your A-disk. 


3 Customize Add, modify, move or delete items on the 
personal menu. 


2 Edit Cmds 3 Save/Exit 4... 5 Diskmode 6 Go 
Bsa 9 Probrep 10... by eee are 


Figure 40. The Editing panel 


Press ENTER. The Undelete window appears again, and shows 
the Password item. 
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ESDEDIT 


Enter commands in the left column. Press PF2 for a command list. 


Press ENTER to view the next deleted item. 
Press PF2 to undelete (recover) the current item. 


Password Change your logon password. 


3 Password Change your logon password. 
4 Customize Add, modify, move or delete items on the 
personal menu. 


2 Edit Cmds 3 Save/Exit 4... 5 Diskmode 
OB sae 9 Probrep 10... LA Gace 


Figure 41. The Undelete window 


7. Press PF2 (Undelete). The Undelete window disappears, and the 
Password item appears again, as shown below: 
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BEaSH B 


BBS B 


ESDEDIT 


Enter commands in the left column. Press PF2 for a command list. 


_ To choose one of the following, type its number and press ENTER: 


1 Main Go to the Main Menu. 
2 Filelist Invokes filelist on your A-disk. 
3 Password Change your logon password. 


4 Customize Add, modify, move or delete items on the 
personal menu. 


2 Edit Cmds 3 Save/Exit 4... 5 Diskmode 6 Go 
G sas 9 Probrep 10... Th, wes Tee secs 


Figure 42. The Editing panel 


8. To add a blank line, type: 


a 


in the prefix area beside item 3 and press ENTER. A blank line 
appears between items 3 and 4, as shown below: 
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ESDEDIT 


Enter commands in the left column. Press PF2 for a command list. 


_ To choose one of the following, type its number and press ENTER: 


1 Main Go to the Main Menu. 
2 Filelist Invokes filelist on your A-disk. 
3 Password Change your logon password. 


4 Customize Add, modify, move or delete items on the 
personal menu. 


2 Edit Cmds 3 Save/Exit 4... 5 Diskmode 6 Go 
Bo wide 9 Probrep 10... 1] eee 12 438s 


Figure 43. The Editing panel 


9. Press PF3 (Save/Exit) to save your changes and exit the editing 
session. The Save/Exit window appears. 
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ESDEDIT 


Enter commands in the left column. Press PF2 for a command list. 


Place the cursor to the left of 
2 Filelis | your choice and press Enter: 
Save Changes and Exit 
3 Passwor Exit Without Saving 
Resume editing 
4 Customi tems on the 


2 Edit Cmds 3 Save/Exit 4... 5 Diskmode 6 Go 
ee G Probrep TO! wine i gets I 


Figure 44. The Save/Exit window 


10. With your cursor beside the Save Changes and Exit selection, press 


ENTER. There is a pause while the menus are filed, then the 
CUSTOMIZATION menu appears again. 


11. Press PF3 (End) to return to the SYSTEM menu. 


You have completed the “delete and undelete items’ example. 
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To test the customized PERSONAL menu, choose panels as shown 


below: 
THE MAIN PERSONAL 
SYSTEM MENU MENU 
MENU 
——_-» —» 
Choose: Choose: 
EndUser Personal 
L 


The PERSONAL menu should look like this: 


ESDL190 VM/I1S - PERSONAL MENU 


To choose one of the following, type its number and press ENTER: 


1 Main Go to the Main Menu. 

2 Filelist Invokes filelist on your A-disk. 

3 Password Change your logon password. 

4 Customize Add, modify, move or delete items on the 


personal menu. 


PF: 1 Help 2 short 3 End 4 Return 5 CMS 6 Go 
Prof  gee BY aad 9 Probrep 10 ... Li eG 12 Retrieve 


Figure 45. The PERSONAL menu 


Press PF4 (Return) to return to the SYSTEM menu. 
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Changing a Menu Title 


In this example, you change the title of the PERSONAL menu, delete 
that title, and add a new title. 


1. To edit the PERSONAL menu, choose panels as shown below: 


THE 
SYSTEM 
MENU 


CUSTOMIZATION 
MENU 


Choose: 
Personal -menu 


Choose: 
Customization 


See below 


2. To edit the menu title, type: 


e 


in the first prefix area, as shown below: 
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ESDEDIT 


Enter commands in the left column. Press PF2 for a command list. 


_ To choose one of the following, type its number and press ENTER: 


1 Main Go to the Main Menu. 


2 Filelist Invokes filelist on your A-disk. 


3 Password Change your logon password. 


4 Customize Add, modify, move or delete items on the 
personal menu. 


2 Edit Cmds 3 Save/Exit 4... 5 Diskmode 
ee 9 Probrep 10... Wt, eee 


Figure 46. The Editing panel 


Press ENTER. The Title Text window appears. 
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L. 


7) 


ESDEDIT 


Enter commands in the left column. Press PF2 for a command list. 


Edit the title text below: 


( VM/IS - PERSONAL MENU 


PFl Help PF2 Keep Changes PF3/12 Cancel 


2 Edit Cmds 3 Save/Exit 4... 5 Diskmode 6 Go 
Cea 9 Probrep 10... eer le wes 


Figure 47. The Title Text window 
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3. Type: 
YOUR PERSONAL MENU 


over PERSONAL MENU, as shown below: 


ESDEDIT 


Enter commands in the left column. Press PF2 for a command list. 


Edit the title text below: 


( VM/TS - YOUR PERSONAL MENU 


PF1 Help PF2 Keep Changes PF3/12 Cancel 


2 Edit Cmds 3 Save/Exit 4... 5 Diskmode 6 Go 
ae 9 Probrep 10... MT 34 1? ... 


Figure 48. The Title Text window 


Press PF2 (Keep Changes). The Title Text window disappears, 
and your new title appears, as shown below: 
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BHREeSEeRSOasgSEeEeESsS B&B BS 


aE 


ESDEDIT 


Enter commands in the left column. Press PF2 for a command list. 


_ To choose one of the following, type its number and press ENTER: 


1 Main Go to the Main Menu. 
2 Filelist Invokes filelist on your A-disk. 
3 Password Change your logon password. 


4 Customize Add, modify, move or delete items on the 
personal menu. 


2 Edit Cmds 3 Save/Exit 4... 5 Diskmode 6 Go 
—_—- 9 Probrep 10... TD. eas . aera 


Figure 49. The Editing panel 


Your next step is to delete the menu title so that you will be able 
to try adding a new menu title. 
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4. To delete the menu title, type: 
d 


in the prefix area, aS shown below: 


ESDEDIT 


_ To choose one of the following, type its number and press ENTER: 


1 Main Go to the Main Menu. 


2 Filelist Invokes filelist on your A-disk. 


3 Password Change your logon password. 


4 Customize Add, modify, move or delete items on the 
personal menu. 


2 Edit Cmds 3 Save/Exit 4... 5 Diskmode 
Ogee 9 Probrep 10... Tl: ged 


Figure 50. The Editing panel 


Press ENTER. The menu title disappears, but the prefix line 
remains. 
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5. Type: 


e 


in the prefix area of the menu title, as shown below: 


ESDEDIT 


Enter commands in the left column. Press PF2 for a command list. 


_ To choose one of the following, type its number and press ENTER: 
1 Main Go to the Main Menu. 
2 Filelist Invokes filelist on your A-disk. 
3 Password Change your logon password. 


4 Customize Add, modify, move or delete items on the 
personal menu. 


2 Edit Cmds 3 Save/Exit 4... 5 Diskmode 
O «ee 9 Probrep 10... U1 eve 


Figure 51. The Editing panel 


Press ENTER. The Title Text window appears again. 


Note: You must use the Edit (e) prefix command because the 
Undelete (u) command does not apply to menu titles. 
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6. Type the menu title text as shown below: 


ESDEDIT EDITING A MENU Menu Item (1 ) of 4 


Enter commands in the left column. Press PF2 for a command list. 


Edit the title text below: 


( VM/IS - MY PERSONAL MENU 


PFl Help PF2 Keep Changes PF3/12 Cancel 


2 Edit Cmds 3 Save/Exit 4... 5 Diskmode 
oO ae 9 Probrep 10... Ii. ge 


Figure 52. The Title Text window 


Press PF2 (Keep Changes). The Title Text window disappears, 
and the menu title appears again, as shown below: 
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BESS B&H B&B 


ESDEDIT 


Enter commands in the left column. Press PF2 for a command list. 


_ To choose one of the following, type its number and press ENTER: 


1 Main Go to the Main Menu. 


2 Filelist Invokes filelist on your A-disk. 


3 Password Change your logon password. 


4 Customize Add, modify, move or delete items on the 
personal menu. 


2 Edit Cmds 3 Save/Exit 4... 5 Diskmode 6 Go 
OC oae 9 Probrep 10... eee Te te, 


Figure 53. The Editing panel 


7. Press PF3 (Save/Exit) to save your changes and exit the editing 
session. The Save/Exit window appears. 
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ESDEDIT 


Enter commands in the left column. Press PF2 for a command list. 


Place the cursor to the left of 
2 Filelis | your choice and press Enter: 
Save Changes and Exit 


3 Passwor Exit Without Saving 
Resume editing 
4 Customi tems on the 


2 Edit Cmds 3 Save/Exit 4... 5 Diskmode 
Bees 9 Probrep 10... te 2G 


Figure 54. The Save/Exit window 
8. With your cursor beside the Save Changes and Exit selection, press 


ENTER. There is a pause while the menus are filed, then the 
CUSTOMIZATION menu appears again. 


9. Press PF3 (Enq) to return to the SYSTEM menu. 


You have completed the “change a menu title” example. 
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To test the customized PERSONAL menu, choose panels as shown 
below: 


| THE vain PERSONAL 
ISYSTEM MENU MENU 
MENU 

= 
Choose: Choose: 
|EndUser | Personal 


The PERSONAL menu should look like this: 


ESDL190 VM/IS - MY PERSONAL MENU 


To choose one of the following, type its number and press ENTER: 
1 Main Go to the Main Menu. 
2 Filelist Invokes filelist on your A-disk. 
3 Password Change your logon password. 


4 Customize Add, modify, move or delete items on the 
personal menu. 


2 Short 3. End 4 Return 5 CMS 
ere 9 Probrep 10 ... A. * setene 12 Retrieve 


Figure 55. The PERSONAL menu 


Press PF4 (Return) to return to the SYSTEM menu. 
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Changing or Adding a Running Header 


In this example, you change a running header, delete that running 
header, and add a new running header. 


1. To edit the PERSONAL menu, choose panels as shown below: 


THE CUSTOMIZATION 
SYSTEM MENU 
MENU 


Choose: Choose: 
Customization Personal-menu 


2. To edit the running header, type: 


e 


in the prefix area to the left of the running header, as Shown 
below: 
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BaHREeBeBeEeEeERBEAaBEeBAaREeRBESaE BH BSB 
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ESDEDIT 


Enter commands in the left column. Press PF2 for a command list. 


To choose one of the following, type its number and press ENTER: 


1 Main Go to the Main Menu. 


2 Filelist Invokes filelist on your A-disk. 


3 Password Change your logon password. 


4 Customize Add, modify, move or delete items on the 
personal menu. 


2 Edit Cmds 3 Save/Exit 4... 5 Diskmode 
Osa 9 Probrep 10 si. ie eee 


Figure 56. The Editing panel 


Press ENTER. The Edit Running Header window appears. 
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ESDEDIT EDITING A MENU Menu Item ( 1 


Enter commands in the left column. Press PF2 for a command list. 


Edit the running header text below: 


{( To choose one of the following, type its number and press ENTER: 


PF1 Help PF2 Keep Changes PF3/12 Cancel 


2 Edit Cmds 3 Save/Exit 4... 5 Diskmode' 6 Go 
=_—_« 9 Probrep 10... he Ss ae 


Figure 57. The Edit Running Header window 


3. Type the word select over the word choose in the window, as 
shown below: 
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BBRBeSBeegegraeseaeageu&:ekn Bs 


BE 


ESUEDIT 


Enter commands in the left column. Press PF2 for a command list. 


Edit the running header text below: 


( To select one of the following, type its number and press ENTER: 


PFl Help PF2 Keep Changes PF3/12 Cancel 


2 Edit Cmds 3 Save/Exit 4... 5 Diskmode 
OP eae 9 Probrep 10... ET teas 


Figure 58. The Edit Running Header window 


Press PF2 (Keep Changes). The Edit Running Header window 
disappears, and choose is changed to select in the running header. 


Note: Your next step is to delete the running header so that you 
will be able to try adding a running header. 
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4. To delete the running header, type: 
d 


in the prefix area to the left of the running header, as shown 
below: 


ESDEDIT 


Enter commands in the left column. Press PF2 for a command list. 


“ To select one of the following, type its number and press ENTER: 


_ 1 Main Go to the Main Menu. 

7 2 Filelist Invokes filelist on your A-disk. 

7 3 Password Change your logon password. 

- 4 Customize Add, modify, move or delete items on the 


personal menu. 


PF: 1 Help 2 Edit Cmds 3 Save/Exit 4... 5 Diskmode 6 Go 
a ar O ose 9 Probrep 10... iG eegeee LZ ees 


Figure 59. The Editing panel 


Press ENTER. The running header and its line disappear. 
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5. Type: 
da 


in the prefix area to the left of the menu title, as shown below: 


ESDEDIT 


Enter commands in the left column. Press PF2 for a command list. 


Go to the Main Menu. 
2 Pilelist Invokes filelist on your A-disk. 
3 Password Change your logon password. 


4 Customize Add, modify, move or delete items on the 
personal menu. 


2 Edit Cmds 3 Save/Exit 4... 5 Diskmode 6 Go 
Geen 9 Probrep 10... jl pees" le ees 


Figure 60. The Editing panel 


Press ENTER. The Select Running Header window appears. 
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EOUEDLT 


Enter commands in the left column. Press PF2 for a command list. 


Place the cursor next to the type of | 
3 Passwor | entry you want and press Enter. 


4 Custom Running header 
Selection item 


Enter PF1l Help PF3/12 Cancel 


2 Edit Cmds 3 Save/Exit 4... 5 Diskmode 6 Go 
GO aes 9 Probrep 10... Te jabs he, tes 


Figure 61. The Select Running Header window 
Note: The second item in the window (Selection item) lets you 
add a selectable item before the first menu item. 
6. Place your cursor next to Running header in the window. 


Press ENTER. The Select Running Header window disappears, 
and a new running header line appears. 
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7. Type: 


e 


in the new prefix area, as shown below: 


ESDEDIT 


Enter commands in the left column. Press PF2 for a command list. 


wee ee em ee ee Me eM Be ew ee ew ee ee em ee ee ee ee ee ee ee ee ee ee ew ee ee ee em em ee em eB em ee ee ee ee eee ew ee eee KK 


Running Header - E to Edit 
1 Main Go to the Main Menu. 
2 Filelist Invokes filelist on your A-disk. 
3 Password Change your logon password. 


4 Customize Add, modify, move or delete items on the 
personal menu. 


2 Edit Cmds 3 Save/Exit 4... 5 Diskmode 
O paix 9 Probrep 10... i err 


Figure 62. The Editing panel 


Press ENTER. The Edit Running Header window appears again. 
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ESDEDIT 


Enter commands in the left column. Press PF2 for a command list. 


Edit the running header text below: 


( Running Header - E to Edit 


PFl Help PF2 Keep Changes PF3/12 Cancel 


2 Edit Cmds 3 Save/Exit 4... 5 Diskmode 
eee 9 Probrep 10... DE goss 


Figure 63. The Edit Running Header window 


8. Type the running header in the window, as shown below: 
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ESDEDIT 


Enter commands in the left column. Press PF2 for a command list. 


Edit the running header text below: 


( To pick one of the following, type its number and press ENTER: 


PFl Help PF2 Keep Changes PF3/12 Cancel 


2 Edit Cmds 3 Save/Exit 4... 5 Diskmode 6 Go 
6 eae 9 Probrep WW eee : ee TA. spieg 


Figure 64. The Edit Running Header window 


Press PF2 (Keep Changes). The Edit Running Header window 
disappears, and the new running header appears on the Editing 
panel. 


9. Press PF3 (Save/Exit) to save your changes and exit the editing 
session. The Save/Exit window appears. 
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ESUEDILT 


Enter commands in the left column. Press PF2 for a command list. 


Place the cursor to the left of 


your choice and press Enter: 
Save Changes and Exit 
3 Passwor Exit Without Saving 
Resume editing 
4 Custom tems on the 


PF: 1 Help 2 Edit Cmds 3 Save/Exit 4... 5 Diskmode 6 Go 
PES? sare —ee 9 Probrep 10... a. ees 12 eed 


“~ 


Figure 65. The Save/Exit window 


10. With your cursor beside the Save Changes and Exit selection, press 
ENTER. There is a pause while the menus are filed, then the 
CUSTOMIZATION menu appears again. 


11. Press PF3 (End) to return to the SYSTEM menu. 


You have completed the “change a running header” example. 
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To test the customized PERSONAL menu, choose panels as shown 
below: 


MAIN PERSONAL 
MENU MENU 
—}+—_»> 
Choose: 
Personal 
L | 


The PERSONAL menu should look like this: 


ESDL190 VM/TS - MY PERSONAL MENU 
To pick one of the following, type its number and press ENTER: 
1 Main Go to the Main Menu. 
2 Frielist Invokes filelist on your A-disk. 
3 Password Change your logon password. 


4 Customize Add, modify, move or delete items on the 
personal menu. 


3 End 4 Return 5 CMS 
Bae 9 Probrep 10 ... Le ees 12 Retrieve 


Figure 66. The PERSONAL menu 


Press PF4 (Return) to return to the SYSTEM menu. 
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In this example, you restore the PERSONAL menu to its original form 
by erasing the customization files that you created in doing the 
examples in this chapter. 


If you want to keep the customized PERSONAL menu, skip this 
example, and follow the instructions in Chapter 4, “Making New and 
Customized Menus Part of Your System” on page 109. 


Note: If you want to keep your customizations, but do not want them 
to be used by your system’s users, change the “ANSWER 
record in the EUAPKG NLSESAQA file from Y to N or a blank. 
For more information, see “Question and Answer Files” on 
page 218. 


The files that you created have filenames that start with ESD and 
EVA. 


The files that you created are on your A minidisk, unless you 
selected a different minidisk with the Diskmode PF key. 
1. If you are using the PF menus, leave them and return to CMS. 
2. Type: 
filelist esd* * a 


on the command line, and press ENTER. The FILELIST screen 
appears. It looks something like: 
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SMITH FILELIST AO V 108 Trunc=108 Size=15 Line=1 Col=1 Alt=0 


Cmd 


l= 
J= 


Filename Filetype Fm Format Lrecl Records Blocks Date 

ESDHGO8 ESAPLIB A2 F 111 3 6/35/88 17% 
ESDHGO5 ESAPLIB A2 105 6/15/88 17: 
ESDHGO6 ESAPLIB A2 1Q7 6/15/88 17: 
ESDHGO7 ESAPLIB A2 LOS 6/15/88 17: 
ESDHGO3 ESAPLIB A2 103 6/15/88 17: 
ESDHGO4 ESAPLIB A2 107 6/15/88 17: 
ESDHGOO ESAPLIB A2 89 6/15/88 17: 
ESDHGO1 ESAPLIB A2 111 6/15/88 17: 
ESDHGO2 ESAPLIB A2 107 6/15/88 17: 
ESDHGOA ESAPLIB A2 91 6/15/88 17: 
ESDH190 ESAPLIB A2 Q7 6/15/88 17: 
ESDHGO9 ESAPLIB A2 109 6/15/88 17: 
ESDL190 XEDIT A2 64 6/15/88 17: 
ESDLGOO = XEDIT A2 6/15/88 17: 
ESDL19  ESDESAOR A2 6/15788 17: 
ESDH191 ESAPLIB A2 6/15/88 15: 
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POF @WM WP DM WL WD WW WW Ww 


Help 2= Refresh 3= Quit 4= Sort(type) 5= Sort(date) 6= Sort(size) 
Backward 8= Forward 9= FL /n 10= 11l= XEDIT 12= Cursor 


scSS> 


Figure 67. The FILELIST screen 


3. 


Check the time stamp and date stamp of the files to make sure 
they were created when you did the examples. 


_. Erase the files that were created. 


. Type: 


filelist eua* * a 


on the command line, and press ENTER. 


. Check the time stamp and date stamp of the files and make sure 


they were created when you did the examples. 


. Erase the files that were created. 


. Erase the ESAIDS PFSETUP file from your A-disk. 
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After you have erased these files, the PERSONAL menu should look 


like this: 


ESDL190 


To choose one of the following, type its number and press ENTER: 


1 Main Go to the Main Menu. 


2 Customize Add, modify, move or delete items on the 
personal menu. 


2 Short 3 End 
CO akce 9 Probrep 10 ... ated 12 Retrieve 


Figure 68. The PERSONAL menu 
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Chapter 3. Creating a New Menu 


This chapter shows you how to create a new menu. 


When you do the example in this chapter, files are created on 
MAINT’s 191 (A) minidisk. (If you prefer, you can use the Diskmode 
PF key to send the files to a different minidisk.) When you have 
finished customizing, you can copy these files to the 322 (O) 
minidisk, as described in Chapter 4, “Making New and Customized 
Menus Part of Your System” on page 109. 


In this example, you create a new menu that will appear asa 
selection on the system PERSONAL menu. 
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This example assumes that you have restored the PERSONAL menu 
to its original form after doing the examples in 
Chapter 2, “Customizing an Existing Menu”. 


This example starts with you logged onto MAINT and looking at the 
SYSTEM menu. To go to the SYSTEM menu, type: 
pf 


on the command line, and press ENTER. 


ETULOQ10 VM/IS - SYSTEM MENU 


To choose one of the following, type its number and press ENTER: 


1 EndUser Invoke the End-User Main Menu. 
2 Customization Invoke the Customization Menu. 
3 New-Menu Create a new menu. 

4 Maintenance Invoke VM/SP Maintenance tasks. 


(C) COPYRIGHT IBM CORP 1988 


2 Short 3 End 4 Return 5 CMS 
GC @ex 9 Probrep 10 ... | are 12 Retrieve 


Figure 69. The SYSTEM menu 
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Creating the Menu 


1. To go to the CREATE A NEW MENU panel, type: 
3 


on the command line of the SYSTEM menu and press ENTER. 
The CREATE A NEW MENU panel appears, as shown below: 


ESDENPN CREATE A NEW MENU 


Information about the panel from which your menu will be called: 


To select from a list of valid calling panel ids, press PF4 Panel Ids. 
PANEL ID OF THE CALLING PANEL .. ( ) 


KEY PHRASE ... ( ) 


DESCRIPTION .. { 
( 
When you have finished, press PF2 EDIT, to edit the new menu. 


2 Edit 3S Exit 4 Panel Ids 5 Diskmode 
Bids 9 Probrep 10... ree 


Figure 70. The CREATE A NEW MENU panel 


2. Type: 


new 
after EUAL, as shown below: 


Note: All panel ids have seven characters. The first four must 
be EVAL. 
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ESDENPN CREATE A NEW MENU 
To create a new panel, fill in the information below: 


PANEL ID OF YOUR NEW PANEL ( EVAL NeW ) 


Information about the panel from which your menu will be called: 


To select from a list of valid calling panel ids, press PF4 Panel Ids. 
PANEL ID OF THE CALLING PANEL .. ( 


KEY PHRASE ... ( ) 


DESCRIPTION .. ( 
( 


| When you have finished, press PF2 EDIT, to edit the new menu. 


2 Edit 3 Exit 4 Panel Ids 5 Diskmode 6 Go 
Bway 9 Probrep 10... i IE ase 


Figure 71. The CREATE A NEW MENU panel 
The calling panel id identifies the menu where this new menu 
will be listed as a selectable item. 


For a list of valid calling panel ids, press PF4 (Panel Ids). The 
Calling Panel ID window appears. 


Note: Introduction, Help, System, and GO panels are not valid 
calling panels. 
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ESDENPN 


PANEL ID OF Y 


Information a 


To select fro 
PANEL ID OF T 


KEY PHRASE .. 


DESCRIPTION . 


When you have 


CREATE A NEW MENU 


Place your cursor next to the desired Calling Panel Id. 


ESDLO1 
ESULIS 
ESDL16 
ESDL19 
ESDL20 
ESDL21 
ESDL24 
ESDL25 


G bas 


vM/IS 
vM/IS 
vM/IS 


3 Exit 


MAIN MENU 
OFFICE MENU 
PROGRAM MENU 
PERSONAL MENU 
TOOLS MENU 
DOCUMENT MENU 
PRINTERS MENU 
GRAPHICS MENU 


4 Panel 


9 Probrep 10... 


Figure 72. The Calling Panel ID window 


Ids 5 Diskmode 
1 ireetae 


3. Move your cursor next to ESDL19 in the window, and press ENTER. 


The window disappears, and ESDL19 appears on the CREATE A 


NEW MENU panel, as shown below: 
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ESDENPN CREATE A NEW MENU 
To create a new panel, fill in the information below: 


PANEL ID OF YOUR NEW PANEL ( EUALNEW ) 


Information about the panel from which your menu will be called: 


To select from a list of valid calling panel ids, press PF4 Panel Ids. 
PANEL ID OF THE CALLING PANEL .. ( ESDL19 ) 


KEY PHRASE ... ( ) 


DESCRIPTION .. ( 
( 


y EXbe 4 Panel Ids 5 Diskmode 6 Go 
eee 9 Probrep 10... i re Te: wets 


Figure 73. The CREATE A NEW MENU panel 


4. Type the rest of the required information in the KEY PHRASE and 


DESCRIPTION fields, as shown below: 


Tailoring Your Menus 
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a 


re 


nme Bf 


BBE & 


cr 


ESDENPN CREATE A NEW MENU 
To create a new panel, fill in the information below: 


PANEL ID OF YOUR NEW PANEL ( EUALNEW ) 


Information about the panel from which your menu will be called: 


To select from a list of valid calling panel ids, press PF4 Panel Ids. 
PANEL ID OF THE CALLING PANEL .. ( ESDL19_ ) 


KEY PHRASE ... ( Yourmenu ) 


DESCRIPTION .. ( This is your multipurpose menu. 
( 


When you have finished, press PF2 EDIT, to edit the new menu. 


3 Exit 4 Panel Ids 5 Diskmode 
OC mes 9 Probrep LO: ges TD +a ae 


Figure 74. The CREATE A NEW MENU panel 


Note: It is important to use a key phrase that is not already used 
by another menu. 


Press PF2 (Edit) to edit the new panel. The Editing panel 
appears, as shown below: 
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ESDEDIT 


Enter commands in the left column. Press PF2 for a command list. 


_ To choose one of the following, type its number and press ENTER: 


2 Edit Cmds 3 Save/Exit 4... 5 Diskmod 
8 Forward 9 Probrep 10... 11 Bottom 


Figure 75. The Editing panel 


5. Type: 
a 


in the prefix area to the left of the running header, as shown 
below: 
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BHeReEeGak & B 


BHReEEeEEHEEUutH B 


BEeaH 


= 


HnPmemumememenmrtenna oa f 


ESDEDIT 


Enter commands in the left column. Press PF2 for a command list. 


a To choose one of the following, type its number and press ENTER: 


2 Edit Cmds 3 Save/Exit 4 ... 5 Diskmode 6 Go 
8 Forward 9 Probrep 10... 11 Bottom ae 


Figure 76. The Editing panel 


Press ENTER. A new prefix area appears. 


6. In the new prefix area, type: 


e 


and press ENTER. The Key Phrase window appears. 
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ESDEDIT 


Enter commands in the left column. Press PF2 for a command list. 


Key Phrase 
Description 


Command ( 
Does the command need ISPF (Y/N)?( N ) 


PF1 Help PF2 Keep Changes PF5 Pick Key Phrases PF3/12 Cancel 


2 Edit Cmds 3 Save/Exit 4... 5 Diskmode 
ee 9 Probrep WwW... MG Sau 


Figure 77. The Key Phrase window 


7. Type the information in the Key Phrase window as shown below: 
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ns Hm DP 


nme BP 


ESDEDIT 


Enter commands in the left column. Press PF2 for a command list. 


Key Phrase Filelist 
Description ( Invokes filelist on your A-disk. 


Command ( exec filelist 
Does the command need ISPF (Y/N)?( N ) 


PFl Help PF2 Keep Changes PF5 Pick Key Phrases 


2 Edit Cmds 3 Save/Exit 4... 5 Diskmode 
BO nee 9 Probrep LO! x04 Ll. wae 


Figure 78. The Key Phrase window 


Note: Since Filelist does not use ISPF, you can leave N as the 
answer to the ISPF prompt. (In general, if you do not 
know the answer to the ISPF prompt, you should answer 
Y), 


Press PF2 (Keep Changes). The Key Phrase window disappears, 
and the Filelist item appears on the Editing panel. 
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8. Type: 


a 


in the prefix area to the left of the Filelist item, as shown below: 


ESDEDIT 


Enter commands in the left column. Press PF2 for a command list. 


_ To choose one of the following, type its number and press ENTER: 


a 1 Filelist Invokes filelist on your A-disk. 


2 Edit Cmds 3 Save/Exit 4... 5 Diskmode 
Ogee 9 Probrep 10... El ses 


Figure 79. The Editing panel 


Press ENTER. A new prefix area appears. 


9. In the new prefix area, type: 


e 


and press ENTER. The Key Phrase window appears again: 
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ESDEDIT 


Enter commands in the left column. Press PF2 for a command list. 


To choose one of the following, type its number and press ENTER: 
1 Filelist Invokes filelist on your A-disk. 
Key Phrase 
Description 


Command ( 
Does the command need ISPF (Y/N)?( N ) 


PFl Help PF2 Keep Changes PF5 Pick Key Phrases PF3/12 Cancel 


2 Edit Cmds 3 Save/Exit 4... 5 Diskmode 6 Go 
B owes 9 Probrep 10... 6 eer IZ. yen 


Figure 80. The Key Phrase window 


10. Press PF5 (Pick Key Phrases). The Pick a Key Phrase window 
appears. 
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ESDEDIT 


Enter commands in the left column. 


To choose one o 


1 Filelis 
Key Phrase 
Description 


Command 
Does the com 


ASF CMSNOTE 
CSP/AE Database 
Document 

DXTADMIN 

GDDM 

Introduction 

List 

NMF Office 
PDF Personal 
Printfile Probman 


2 Edit Cmds 3 Save/Exit A -ieskes 


B gave 


9 Probrep 10... 


Figure 81. The Pick a Key Phrase window 


Press PF2 for a command list. 


Place the cursor on the reserved salection item you 


want on your menu, and press Enter. 


CSP/AD 
DBEDIT 
DXT 
Files 
Graphics 
Library 
News 
Password 
Printers 
Probrep 


5 Diskmode 6 Go 
WH tea 12... 


11. Move your cursor to the item Password, and press ENTER. 


The Pick a Key Phrase window disappears, and the Key Phrase 
window is filled in with the required information, as shown 


below: 
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BPReenwmweeneenFenrn ne fo 


BES B 


ESDEDIT 


Enter commands in the left column. Press PF2 for a command list. 


To choose one of the following, type its number and press ENTER: 


1 Filelist Invokes filelist on your A-disk. 


2 Password Change your logon password. 


Key Phrase Password 
Description ( Change your logon password. 


Command ( EXEC ESAPW 
Does the command need ISPF (Y/N)?( N ) 


PF1 Help PF2 Keep Changes PF5 Pick Key Phrases PF3/12 Cancel 
: 1 Help 2 Edit Cmds 3 Save/Exit 4... 5 Diskmode 
Pre oF wate GO wes 9 Probrep 10... ji eres 


ESAEDQ24 You cannot change this item. 


===> 


Figure 82. The Key Phrase window 


12. Press PF2 (Keep Changes). The Key Phrase window disappears, 


and item number 2 appears on the Editing panel. 


Chapter 3. Creating a New Menu 


101 


102 


ESDEDIT 


Enter commands in the left column. Press PF2 for a command list. 


_ To choose one of the following, type its number and press ENTER: 


1 Filelist Invokes filelist on your A-disk. 
2 Password Change your logon password. 


2 Edit Cmds 3 Save/Exit 4... 5 Diskmode 6 Go 
ence 9 Probrep 10... i) eee Ie) carats 


Figure 83. The Editing panel 


13. To add a blank line between items 1 and 2, type: 


dq 


in the prefix area to the left of the Filelist item, as shown below: 


Tailoring Your Menus 


nHnrRmRemenrnrertes se B 


ESDEDIT 


Enter commands in the left column. Press PF2 for a command list. 


_ To choose one of the following, type its number and press ENTER: 


1 Filelist Invokes filelist on your A-disk. 
2 Password Change your logon password. 


2 Edit Cmds 3 Save/Exit 4... 5 Diskmode 
Be ies 9 Probrep 10... TT saeete 


Figure 84. The Editing panel 


Press ENTER. A blank line appears between items 1 and 2, as 
shown below: 
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ESDEDIT EDITING A MENU Menu Item ( 1 


Enter commands in the left column. Press PF2 for a command list. 


_ To choose one of the following, type its number and press ENTER: 
1 Filelist Invokes filelist on your A-disk. 


2 Password Change your logon password. 


2 Edit Cmds 3 Save/Exit 4... 5 Diskmode 6 Go 
a 9 Probrep 10... | A aw 


Figure 85. The Editing panel 


14. Press PF3 (Save/Exit) to save your changes and exit the editing 
session. The Save/Exit window appears. 
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ESDEDIT 


Enter commands in the left column. Press PF2 for a command list. 


To choose one of the following, type its number and press ENTER: 


1 Filelis 
Place the cursor to the left of 
2 Passwor | your choice and press Enter: 
Save Changes and Exit 
Exit Without Saving 
Resume editing 


2 Edit Cmds 3 Save/Exit 4... 5 Diskmode 
O aes 9 Probrep TO 5 ae% bk... 


Figure 86. The Save/Exit window 


15. With your cursor beside the Save Changes and Exit selection, press 
ENTER. There is a pause while the menus are filed, then the 


SYSTEM menu appears again. 


You have completed the “creating a new menu” example. 


Testing the New Menu 


1. To test the customized PERSONAL menu, choose panels as 


shown below: 
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THE | MAIN | PERSONAL 
SYSTEM MENU MENU 
MENU 

+—» 
Choose: Choose: Choose: 
EndUser _ Yourmenu 


The PERSONAL menu should look like this: 


ESDL190 VM/TS - PERSONAL MENU 


To choose one of the following, type its number and press ENTER: 


1 Main Go to the Main Menu. 
2 Customize Add, modify, move or delete items on the 


personal menu. 
3 Yourmenu This 18 your multipurpose panel. 


2 Short 3. End 4 Return 5 CMS 
O° awe 9 Probrep 10 ... el 


Figure 87. The PERSONAL menu 


12 Retrieve 


[ = 


Li 


BHeEaEtB Ss 


| 


Note: You can add a blank line between items 2 and 3 by 
customizing the system PERSONAL menu, as described in 
Chapter 2, “Customizing an Existing Menu”. 
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2. To go to your new menu, type: 


3 
on the command line of the PERSONAL menu, and press ENTER. 


EUALNEWO YOURMENU MENU 
To choose one of the following, type its number and press ENTER: 
1 Filelist Invokes filelist on your A-disk. 


2 Password Change your logon password. 


2. Short 4 Return 5 CMS 
: mas 9 Probrep 10 ... Le ade 12 Retrieve 


Figure 88. Your New Menu 


On this menu, you can select / to see a Filelist, or 2 to change 
your password. 


3. Press PF4 (Return) to return to the SYSTEM menu. 
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Chapter 4. Making New and Customized Menus Part of Your 
System 


This chapter tells you how to add your new menu or customized 
menu to the system. 


When you created a new menu or customized an existing menu, you 
created several files on your A minidisk. In this chapter, you copy 
these files to the 322 (O) minidisk, and erase them from MAINT’s 191 
(A) minidisk. This makes your changes available to all users on your 
system. 


If you customized an existing menu, the files you created have 
filenames that start with ESD or EVA. 
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lf you created a new menu, the files you created have filenames that 
start with ETU. 


(When customizing, you could use the Diskmode key to write your 
files directly onto the 322 minidisk. This would save you a few steps, 
but it would also be much riskier.) 


Getting Write Access to the 322 Minidisk 


If you do not already have write access to the 322 minidisk, enter the 
following commands: 


link maint 322 322 wr 
acc 322 0 


To verify that you have write access, enter: 
q links 322 


You should see: 
MAINT 322 R/W 


If any other users are attached to this disk, ask them to detach it. 


Copying the Files to the 322 Minidisk 


Follow the instructions below for each set of files that you created. 


lf you created a new menu, you will follow these instructions for 
ETU... files. 
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If you customized an existing menu, you will follow these instructions 
once for ESD... files, and then again for EUA... files. 


1. Go to the FILELIST screen by entering one of the following 


commands: 


e filelist eua* * a 
e filelist esd* * a 


e filelist etu* * a 


. Check the time stamp and date stamp of the files to make sure 


that they were created when you did the examples. 


. Beside each file that you created, type: 


copyfile / = = 0 (replace 


. Press ENTER. 


. Beside each file that you copied, type: 


erase 


. Press ENTER. 
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Part 2. Advanced Tailoring 


This part describes how to make more complex changes to the PF 
than those outlined in “Part 1. Basic Tailoring”. 


Basic tailoring tasks use the panel-driven tailoring facility. 
Advanced tailoring tasks, being more complex, require a knowledge 
of both the tailoring facility and certain files and commands. 


The examples in this part show you how to: 


e add an application to the PF 
e add online Help panels 
¢ add an Introduction topic. 


Additional information explaining PF files and naming conventions is 


contained in the Appendixes. Refer to this information for a more 
complete understanding of advanced panel tailoring. 
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Chapter 5. Introduction to Advanced Tailoring 


This introductory chapter defines the processes and terms needed to 
understand advanced tailoring. This chapter defines panel types 

and panel connections. It discusses the process of panel building. It 
relates files to the building process and to the appearance of menus. 


The advanced tailoring tasks, shown by example in the following 


chapters, require basic knowledge of CMS and XEDIT and additional 
knowledge of REXX, EXEC 2, and ISPF. 
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The Productivity Facility has the following types of panels: 


Long version menus 
Short version menus 
GO menus 


All of the above let you select a function or another menu. 
Information on the GO and Short versions of the menus its 
derived from information on the Long version. 


Help panels 
Online Introduction panels. 


These panels give detailed information about functions and 
products that are available on your system. 


“Panel Types’ on page 4 shows an example of each of these panel 
types. 


The following illustrations show how these panels are connected to 
one another. 
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bn DB 


ow 


ESUL-220 


1 AS 
2 ASF 


3 Batch 


4 OMSNOTE 
5 CSP/AD 
6 CSP/AE 
7 Customize 


§ DBEDIT 
8 Ow370 


bass Abe ig 


To chaose one of the following, 


ALPHABE T:( CAL LIST) OF TOS Poge ! of 5 


personal manu. 


Edit dato ina relational 
Create documenta using DiabloyWri te/370. 


{Continued Presa PFA) 
Help 2 Short 3 Eng 4 Return ‘$s OS 6 Go 
i 8 Forwor Prabreap 10 11 Botton 12 Retrieve 


Se 
SURE ICAL LIST OF FUNGT LONS: eel & 


E223 


WIS - 


--=> == mee 


Poge 2 oa! 6 


wis 


ALPHABET ICAL LIST OF PTS 


SS ees aes ——— 


Help panels ter ach nu item fol low To read the Hel ot the For touine, rae t@ number sea press “ENTER: 
gequentiaily, prese HNTER To see ct specific Help, type Loe 
cumber of the menu ifem on the commond [ine and preas ENTER 1 AS 
2 ASF 12 Edit 2G NMF 
1 aS se the Application Syaten * 
2 ASF ROFS Applications Support Feature (PROFS ASF). a 3 Betcn 13 Files 2) Posaword 
22 PDF 
3 Gatch un progroms in background A 4 OVGNOTE 14 GDDM 23 PRINTI812 
S CSP/AD 15 GO 24 Printhilea 
« OVSNOTE Send CMS nates and messager. “XN 6 CSP/AE 25 Probman 
5 CSP/AD Orvelop Cross System Product apn! ications ee 7 Customize 16 [mtroduction 24 Probrap 
6 CSP/AE Ekecute Cronm Syatem Product opp! ications be 17 (SQL 27 PROFS 
7? Customize id. modify, move or delete itemm on the SS 8 OSBEDIT 28 PROF SDOC 
sonal menu 9 OW370 18 Library 29 PROFSMAIL 
‘ 10 DXT 3Q PROFSNOTE 
8 OBEDIT EdAt data in a relational dato base. oa) OXTADMIN: 19 Moin 
(Continued. Prese PFB) KGans' inane 
14 2 End 4 Return 5 ONS 6 Go 2 Lang 3 Ena: 4 Return 5 Os 
Forward 9 Reena _ (as 11 Bottam 12 Retrieve 8 Forward 9 Probrep [0 : 11 Bottom 


S 


Page 1 af 2 


Press PFA) 


6 Go 
12) Retrieve 


On any VM/IS menu, you can press PF2 to switch between the Long 
version and the Short version of the menu. From either version of 
the menu, you can press PF1 to go to a Help panel. 
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all 


—{MAIN MENU} —~———__ 


VW/TS - MAIN MENU: 


to choose one of the fotlowing. type Jts number and press ENTER: 
1 Tools Choose froma jist of toale and oppticatiana. 
2 Persona! Your awn menu that you can customize. 
3 Office Perform administratian and communication taske. 
4 Document Work with documents 
5 Printers Print files. 
6 Program Computer programming 
7 Database Store ond retrieve dato. 
B Graphics Produce grapha. 
@ VMToskes Work with CMS files and syatem resources. 
10 Liat Choose from on aiphobetical tiat of VW/IS functions. 
1! Introduction Read chout. V4/iS functions. 
12 GO Moke option selectiona using a shartcut. 
(C) COPYRIGHT [GM CORP 1988 


Ratrieve 


- —6o PANEL} ——___ 


INTRODUCTION PANEL] 


a 


ESIMAAIO INTRODUCTION TOPICS MENU Page | of 2 | 


Page I of 5 


To choose one of the foliowing., type its mumber and orasa ENTER: 


Choose a topic or prese PFA to see more topica: 


To view more items on thie panel, prase PF2 (Short). 1 Ovarviow About thi introduction. 
1 Tools Choose froma tiat of toala ond app! ications. 
1.) Library Choose froma jist of application programs. 2 Facilities Using the VM/IS-Productivity Facility fecturos. 
{2 News Read the iatast news. 
1.3 Paseword Chonge your logon possaword Tools Choose froma list of togim and applications. 
1.4 Probman Monage problem reports assigned ta you 
1.5 Prabrep Report probiemes and visw their atatue. Introduction ta Application System. 


Z Persona! Your own menu that you con customize- Your own menu that you can customize 
2.1) Main Go to the Main Menu, 
2.2 Customize Add. modify, move or delete it on the 6 Office Parforming Office Tasks 


persona! manu. 


7 Decumant Creating documenta. 


(Continuad... Press PFB) 


(Continued... Press PFB) 


3) End 


3) End 4 Return 5 6 


PF. 1 Help 2 Short 4 Returns 5 Q6 6 Go REST wre By were a Bis 
BRi 2 tree @ Forword 9 Probrep 10 ... 11 Bottom 12 Retrieve sl cee 8 Forward § Frobrep 10 .. 1% Bottom $2 Retrieve | 
w-e2> 1 } ===> 


On the MAIN menu, there are two special selections. If you select 
11, you go to an Introduction Topics panel. If you select 12, you go to 
the GO menu. There is only one GO menu. It is built automatically 
from information provided by the other panels. You should tailor 
only the title, preface, and running header on the GO menu. 
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Types of Files 


For advanced tailoring, you must be familiar with the following types 
of files: 


e item files 

e slot request files 

° package definition files 

¢ question and answer files. 


Sa a a a a ee er Sn a aa eee eee eee 
Item Files 


All text that appears on an application’s menu ts stored in an item 
file. The item file for a selectable menu item identifies the EXEC that 
is executed when an item is chosen. If that item has online help 
associated with it, the item file names the file that displays the HELP 
panels. 
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TOOLS ITEM FILE 


To choose one of the following, types its number ond preas ENTER: 


MENU CONTENT 


1 Tools Choose froma iiat of tools and appticationa. 
SAN AREER LE LE Cee Ne oe ee a ee 2 Parsona: Your own manu that you con customize. 
Fi 5 > 3 Office Parfarm administratian and communication tosk 
| DESCRIPTION TEXT Choose trom @ int of tele ond oppi leations. 4 Document Work with documents: = ‘ 
5 Printera Print filee. 
6 Program Computer programming. 
[sKEY_PHRASE Tools 7 Database Store and retrieve dato. 
—=— 8 Grophics Produce graphe. 
9 VMTonke Work wilh CMS files ond ayatem resources. 
| *COMMAND2 ESAFLO ESDL200 10 Liet Choose from an alphabet!ca! ‘int of VWW/IS functions 
11 Introduction Read about VW/IS functiona. 
| «NEXT_PANEL ESDL20 ‘2 GO Moke option selections using o shortcut. 
| SHELP_COMMAND ESAFM ESDTOOLS ER COPYRIGHT TEM CORP 1988 
Se PF: 1 Help 2 Short 3 End 4 Return 5 OS 6 Go 
PF? az a ® Prabrep 10 ... iD Hee 12 Retrieve 


SELECTION PROCESSING 


HELP MENU TOOLS MENU 


ESDL200 W'S - TOOLS MENU 


To choose ane of the follaw!ng. type |t# number and prensa ENTER 


ESOTOOH} TOOLS: HELP 


Choosa TOOLS to see a list of toola and applications 


available to you ta help you in your daily activitias. ; peecory Sieee, fhe ye. Aek ®t application progroms. 
Th I f 3 Password Change your togan possword. 
sortie oeiccon from a simple calculator ta o 4 Protran Manoge problem reports ompigned to you. 
5 Probrep Report probdiems and view their status, 
6 Remote Lag on to o remote computer system. 
PF 4... D555 3 End 4 Return 5 CMS 6 Go pA : 
PF 7 Bockward @ forword 9 Probrep 10... 1... 12 Retrieve Brie 3 8. 9 Probrap 10 . . Woe, 12 Ratrieve 


=—==> 


===> 
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Slot Request Files 


Slot request files specify: 


e The application’s menu names 
e The order of items on the application’s menus 


e The names of the item files that contain details about each item 
on each menu. 


Slot request files are identified by a three letter component code, 
which ts part of their filename. 
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1. ORDER OF APPEARANCE 


® Slot request records 


s 100 esd120 esdlibra 


s 100 esd120 esdpw 1200|esdpw esaitema 


s 100 esd|20 esdnews 


Relative order number 


2. MENU NAME AND MENU CONTENT 


@ Slot request record - news 


s 100[esdi20]esdnews 1000 


ITEM FILE ESDNEWS 


*DESCRIPTION_TEXT Read the latest news 
*KEY_PHRASE News 

*COMMAND2 EXEC ESDLM 
*HELP_COMMAND ESAFM ESONEWSA 
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900 ;esd!/ibra esaitemais and applications 


esdnews esai tema 


TOOLS MENU 


YM/TS, - TOOLS MENU 


1 Library Choose froma list of application programs, 
2 News Reod the totest news. 

3 Posaword Change your logon paseword. 

4 Probmon Manage problem reparts agsigned to you. 

5 Protrap Report probiems ond view thair statue. 

6 Ramte Log on to o remote computer systom, 


3) End 4 Return 5 Os 6 Go 
9 Probrep 10 ... if re 12 Retriave 


TOOLS MENU 


ESOL200 vWw71S - TOOLS MENU 


Ta choose one of the following, type its number ond preas ENTER: 


1 Library Choose fromo list of opplicat:an programs. 
2 News Read the !ctest news 

3 Pasaword Change your Ig possword. 

4 Probmon Manage prp reports assigned ta you. 

5 Probrep Repor$-pfoblems and view their atatus 

6 Rarote L to a remote computer ayatom 


PF- 1 Help 2 Short 3 Ena 4 Return 5 Os 6 G 
PF: 7 6. 9 Probrap 10 P \ i 12. Retrieva 


<=> 
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Package Definition Files 


Each application has its own unique component code. The package 
definition file contains this component code. 


Question and Answer Files 


The question and answer file contains the question that is asked 
about a package when you build the panels. 


By answering this question, you include or exclude a packaged 
application and all the panels associated with it. 


Par E Se ee Ra ee eee Eee ae ee ee ee 
The Panel Building Process 


You use the PFSETUP EXEC to rebuild panels from information in 
package definition, question and answer, slot request, and item files 
The following figure shows when each file is used in the panel 
building process. 
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Package 
Definition 
Files 
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Files 


Slot 
Request 
Files 


PFSETUP 


Create 
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Define 
Menus 
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Panel 
Definition 


Files 


Item i 
Files 


Figure 89. The PFSETUP EXEC and the Panel Building Process 


The PFSETUP EXEC goes first to the package definition file. From 
the package definition file, it gets the component codes associated 
with a package. 


It then asks the question contained in the question and answer file. 
The question looks something like this: 


EGQ101I Do you want to include xxxxxxxx in the menus? 


If you answer \, PFSETUP ignores this package. If you answer |, 
PFSETUP includes this package. 
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For each included package, PFSETUP finds the slot request files 
whose filenames start with one of the component codes. The slot 
requests for each logical panel are put into a panel definition file. 
One panel definition file is built for each logical panel. 


The slot requests in the panel definition file identify the item files 
that are used for that logical panel. The key phrase and description 
text for each item are contained in an item file. Other item files 
contain text such as the title or running header. 


The relative order numbers of the slot requests determine the order 
of items on a logical panel. If there are too many items to fit on one 
panel, two or more physical panels are built for a single logical 
panel. 


The panels go into ISPF panel libraries named ESAPLIB MACLIB and 
ETUPLIB MACLIB, and XEDIT macros with the same filename as the 
panel ID. 
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Packaging an Application 


The advanced tailoring instructions show you how to add a packaged 
application to your menus. 


A packaged application has: 


¢ a unique three-character component code 

¢ a package definition file 

¢ a question and answer file 

e item files and slot request files for the menu items. 


All of the filenames begin with the component code. 
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Panel IDs 


Whenever you build the PF panels, you can choose to include or 
exclude all of the selections for a packaged application. 


(By contrast, the basic tailoring instructions show you how to add 
menu items that are not packaged. You add or remove these items 
by customizing individual menus.) 


If you want panel identifiers to appear on your panels, type: 


panelid on 

on the command line of any panel. 
Type: 

panelid off 


to turn them off again. 


Different Types of Panel IDs 
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The Long, Short, and Help menus are all constructed from the same 
logical panel information, and may be thought of as different views of 
the same information. They have the same logical panel ID, except 
for the letter L, S, or H. 


For example, the LIST logical panels have panel IDs in the form 
ESDx22: 


e ESDL22 is the panel ID of the Long logical panel 
e ESDS22 is the panel ID of the Short logical panel 
e ESDH22 is the panel ID of the Help logical panel. 
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Each logical panel is displayed on the screen as one or more 
physical panels. The physical panel IDs are formed by adding a 
number from 0 to 9 or a letter from A to Z to the logical panel ID. 


For example, the Long version of the LIST panel consists of five 
physical panels with the following panel IDs: 


¢ ESDL220 
¢ ESDL221 
¢ ESDL222 
* iESDL223 
¢ ESDL224. 


PROFS menus 


If you install the Text/Office System package, the items from the 
TOOLS menu are included on the PROFS main menus. (PROFS 
comes with the Text/Office System package.) 


If you add menu items to the TOOLS menu, you can add them to the 
PROFS main menus as well. 
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Online Introduction menus 


A narrative unit is a sequence of narrative panels. Narrative units 
are linked to the online introduction topic and subtopic menus with 
item files. 
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Chapter 6. Adding and Packaging an Application 


The Advanced Tailoring chapters fit together as follows: 


e Chapter 6 shows how to add an application. 

e Chapter 7 shows how to add online help panels for the 
application. 

¢ Chapter 8 shows how to add an introduction topic for the 
application. 


Once you have added the application, the help panels, and the 


introduction topic, you should rebuild, test, and save the panels, as 
described in chapter 9. 
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The examples in this chapter use the panel tailoring facility, 
introduced in “Part 1. Basic Tailoring”, to add an application. Then, 
each application is packaged to include it with the other products 
already installed on the PF. Packaging an application involves 
renaming two types of files and creating two other types. 


You rename and edit: 


e the Item file 
e the Slot Request file 


You create: 


¢ the Package Definition file 
e the Question and Answer file 


using examples provided by VM/IS. 


The instructions in this chapter assume that you have completed the 
Basic Tailoring examples, and still have the files that you created on 
MAINT’s A minidisk. (If you did not do the Basic Tailoring examples, 
you will need to create new files instead of renaming the files 
indicated in the following instructions.) 


The instructions in this chapter assume tnat all VM/IS products have 
been installed on your system. (If you do not have all VM/IS 
products, you may see slightly different panels.) 


To do the examples in this chapter, you must have read access to 
the 322 and 326 minidisks. To get read access, enter the following 
commands: 


access 322 a/0 
access 326 n/n 
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The Example Application 


Suppose you have installed Computer-graphics Augmented Design 
and Manufacturing (CADAM)' on your system, and you want to make 
it available to users by adding an entry on the menus. You decide to 
add the entry on the GRAPHICS menu after the menu item GDDM. 


By following the instructions in this example, you use the tailoring 
facility to add the application. This creates the item, slot request, 
and panel definition files. You then package the application by 
renaming and editing these files and the sample package definition 
and question and answer files which come with VM/IS. 


Before you begin, you choose a three-character component code for 
your package. Choose a code that is different than the codes used 
by the PF or any other application on your system. Refer to 
Appendix A, “Naming Conventions” on page 20/7 for a list of codes 
used by the PF. In this example, EG2 represents the unique 
component code you choose for your package. All of the files you 
create in this example start with this component code. 


The instructions in this chapter show you how to: 


1. Add an application to the GRAPHICS menu 
2. Package your application. 


1 CADAM is a trademark of Cadam, Inc. 
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Adding the Application 


At the start of this example, you should be logged onto MAINT and 
looking at the SYSTEM menu. To go to the SYSTEM menu, type: 


pf 
on the command line, and press ENTER. 


1. To go to the Editing panel of the GRAPHICS menu, choose panels 
as shown below: 


CUSTOMIZATION 
MENU 


Choose: 
Graphics-menu See below 


Customization 


2. To add CADAM after the GDDM item, type: 
a 


in the prefix area, as shown below: 
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ESDEDIT 


Enter commands in the left column. Press PF2 for a command | ist. 


_ To choose one of the following, type its number and press ENTER: 
1 GDDM Create two- and three-dimensional color 


charts and graphs. 
2 AS Produce Business Graphics using Application System. 


: 1 Help 2 Edit Cmds 3 Save/Exit 4... 5 Diskmode 6 Go 
DO: ek 9 Probrep 10... Th, ey % | re 


Figure 90. The Editing panel 


Press ENTER. A new prefix area appears below GDDM. 
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ESDEDIT 


Enter commands in the left column. Press PF2 for a command list. 


_ To choose one of the fal outta, type its number and press ENTER: 


1 GDDM Create two- and three-dimensional color 
charts and graphs. 


Produce Business Graphics using Application System. 


2 Edit Cmds 3 Save/Exit 4... 5 Diskmode 
S 424 9 Probrep 10... Te * ecgrcs 


Figure 91. The Editing panel 


3. In the new prefix area, type: 


e 


Press ENTER. The Key Phrase window appears. 
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Enter commands in the left column. Press PF2 for a command list. 


To choose one of the following, type its number and press ENTER: 


Create two- and three-dimensional color 
charts and graphs. 


Key Phrase CADAM 
Description ( Work with design drawings. 


( 
Command ( EXEC EG2CADM 
Does the command need ISPF (Y/N)?( N ) 


PFl1 Help PF2 Keep Changes PF5 Pick Key Phrases PF3/12 Cancel 


PF: 1 Help 2 Edit Cmds 3 Save/Exit 4... 5 Diskmode 
Oasis 9 Probrep 10... i eee 


Figure 92. The Editing panel 


CADAM will be invoked by an EXEC named EG2CADM. 


Note: The VM/IS-Productivity Facility provides the capability for 
initializing ISPF before the invocation command for your 
product is executed. This is provided as a programming 
interface. To specify the initialization of ISPF, type y in the 
Does the command need ISPF? field. For more details on this 
programming interface see the description of “COMMAND 
in the content item file section of “Content Item Files” on 
page 244. 


Press PF2 (Keep Changes). The Key Phrase window disappears, 
and the new item appears on the Editing panel. 
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ESDEDIT 


Enter commands in the left column. Press PF2 for a command list. 


_ To choose one of the following, type its number and press ENTER: 


1 GDDM Create two- and three-dimensional color 
charts and graphs. 
2 CADAM Work with design drawings. 
3 AS Produce Business Graphics using Application System. 


2 Edit mds 3 Savef/Exit 4 ... 5 Diskmode 6 Go 
8 aes 9 Probrep eo Vt ads U7. aes 


Figure 93. The Editing panel 


5. Press PF3 (Save/Exit) to save your changes and exit the editing 


session. The Save/Exit window appears. 
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Enter commands in the left column. Press PF2 for a command list. 


To choose one of the following, type its number and press ENTER: 


onal color 
Place the cursor to the left of 
2 CADAM your choice and press Enter: 
3 AS Save Changes and Exit ng Application System. 
Exit Without Saving 
Resume editing 


: 1 Help 2 Edit Cmds 3 Save/Exit 4... 5 Diskmode 
GO See 9 Probrep 10... Hh 


Figure 94. The Save/Exit window 


6. With your cursor beside the Save Changes and Exit selection, press 
ENTER. There is a pause while the menus are filed, then the 
CUSTOMIZATION menu appears again. 


7. Press PF3 (End) to return to the SYSTEM menu. 


Creating the Selection Processing EXEC 
This is the EXEC you specified as the Command in the Key Phrase 
window. It is executed when the user selects CADAM from the 


GRAPHICS menu. 


Ordinarily, you would put the commands needed to invoke CADAM 
in this EXEC. 
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In this example, you create an EXEC that displays a message saying 
that CADAM is not installed yet. 


Create a file named EG2CADM EXEC, containing the following lines: 


/* Menu tailoring temporary exec. */ 
address COMMAND 


trace off 
say 'CADAM is not installed yet.' 
exit 


You have completed the “adding an application” step. 


Packaging the Application 
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The tailoring facility automatically creates the item, slot request, and 
panel definition files. The item and slot request file names start with 
EUA. The panel definition file has a filetype of ESDESAOR. 


The first step in packaging your application is to rename and edit 
these files to include the component code you have chosen for your 
application. In this example, the component code is EG2. 


The files created by the tailoring facility are on MAINT’s A disk. To 
see a list of the files created when you added CADAM to the 
Graphics menu you leave the Productivity Facility. 


1. Press PF3 (End) to leave the PF. 
2. Type: 
filelist eua* * a 


on the command line, and press ENTER. 
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A list of files appears. Part of that list is shown below. Verify, using 
the time and date stamp, that these files were created when you did 
the previous part of this example. 


SMITH FILELIST AO V 108 Trunc=108 Size=63 Line=1 Col=1 Alt=0 

Cmd Filename Filetype Fm Format Lrecl Records Blocks Date Time 
EUA ESASRHM$ A2 V 37 1 1 6/15/88 12:47:56 
EUA1 ESAITEMA A2 V 69 3 1 6/15/88 12:47:56 


1= Help 2= Refresh 3= Quit 4= Sort(type) 5= Sort(date) 6= Sort{size) 
7= Backward 8= Forward 9= FL /n 10= 1l= XEDIT 12= Cursor 


=222> 


Figure 95. The FILELIST screen 


Note: The number at the end of the EUA filename represents the 
number of existing EUA* ESAITEMA files. 
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Renaming the Item File 


Item files have a filetype of ESAITEMA and their filename must start 
with the component code for their specific application program. To 
verify and then rename the item file created in this example: 


1. Place your cursor beside the newly created item file. 
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2. Press PF11 (XEDIT) to see the contents of the file. 


*KEY PHRASE CADAM 

*DESCRIPTION TEXT Work with design drawings. 
*COMMAND2 EXEC EG2CADM 

*HELP_COMMAND ESAFM ESADHLP 


Note: The commands in the item file are always in upper case. 


For more detail about item files, refer to “Item Files” on 
page 235 and Appendix B, “Files and Formats” on page 215. 


3. Press PF3 (Quit) to return to the filelist. 


4. To rename the item file with your component code type: 


rename / eg2cadm = = 


beside the filename, as shown below: 


SMITH FILELIST AQ V 108 Trunc=108 Size=63 Line=1 Col=1 Alt=0 

Cmd Filename Filetype Fm Format Lrec] Records Blocks Date Time 
EUA ESASRHM$ A2 V 37 1 1 6/15/88 12:47:56 

rename / eg2cadm = =EMA A2 V 69 3 1 6/15/88 12:47:56 


l= Help 2= Refresh 3= Quit 4= Sort(type) 5= Sort(date) 6= Sort(size) 
7= Backward 8= Forward 9= FL /n 10= 11l= XEDIT 12= Cursor 


Figure 96. Renaming the Item File. 


5. Press ENTER. 
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SMITH FILELIST AO V 108 Trunc=108 Size=63 Line=1 Col=1 Alt=0 

Cmd Filename Filetype Fm Format Lrecl Records Blocks Date Time 
EUA ESASRHM$ A2 V 37 1 1 6/15/88 12:47:56 
EUAI ESAITEMA A2 ** Discarded or renamed ** 1 6/15/88 12:47:56 


l= Help 2= Refresh 3= Quit 4= Sort(type) 5= Sort(date) 6= Sort(size) 
7= Backward 8= Forward 9= FL /n 10= 11= XEDIT 12= Cursor 


=s2==> 


Figure 97. The FILELIST screen 


6. Press PF3 (Quit) to leave the filelist. 


Creating the Slot Request File 


Since you renamed the item file, the name must also be changed in 
the slot request file. To edit the slot request file created in this 
example: 


1. Type: 
filelist * esasrhm$ a 


on the command line, and press ENTER. 
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SMITH FILELIST AO V 108 Trunc=108 Size=63 Line=1 Col=1 Alt=0 


Cmd Filename Filetype Fm Format Lrec]l Records Blocks Date Time 


EUA ESASRHM$ A2 V 37 1 1 6/15/88 12:47:56 


l= Help 2= Refresh 3= Quit 4= Sort(type) 5= Sort(date) 6= Sort(size) 
7= Backward 8= Forward 9= FL /n 10= 11= XEDIT 12= Cursor 


=sSS> 


Figure 98. The FILELIST screen 


pas 


Verify, using the time and date stamp, that EUA ESASRHM$ was 
created or updated when you added CADAM to the GRAPHICS 
menu. 


. Place your cursor beside the EUA ESASRHM6$ file and type: 


copyfile / eg2 = = 


. Press ENTER. 
. Press PF2 (Refresh). 
. Place your cursor beside EG2 ESASRHM$ and press PF11 


(XEDIT). 


. Find the following record, which corresponds to the item file you 


just created: 
S 150 ESDL25 EUA251 800 EUA] ESAITEMA 
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dat 


Change EUA251 to EG2251, and change EUA1 to EG2CADM, as 
indicated below: 


S 150 ESDL25 EG2251 800 EG2CADM ESAITEMA 
(Depending on what you have done previously, the slot number 


may not be 800. Also, the file that you created may be an EUAx 
file other than EUA1.) 


. Delete all other records from the file. 


. Type: 


file 
on the command line, and press ENTER. 


To remove the record you changed in the EG2 file, press PF11 
(XEDIT) beside EUA ESASRHMS. If the file contains more than 
one record, delete the record that you changed in the EG? file. If 
the file contains only one record, erase the file. 


Press PF3 (Quit) to leave the filelist. 


For more detail about slot request files, refer to Appendix E, “More 
Information about Slot Request Files” on page 271. 


a a SS ES eS eS SS SS Se SS ee ee ae eS 
Creating the Package Definition File 


The tailoring facility does not create the package definition file. You 
must create this file yourself. 


In this example, you copy an existing file and use it as the basis for 
your new file. 
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1. To see a list of the package definition files shipped with VM/IS 
type: 


filelist * esapkg * 
on the command line, and press ENTER. 


2. Copy ESDPKG ESAPKG to your A disk and rename it as shown 
below: 


SMITH FILELIST AO V 108 Trunc=108 Size=9 Line=1 Col=1 Alt=0 
Cmd Filename Filetype Fm Format Lrecl Records Blocks Date Time 
ETXPKG  ESAPKG V 70 25 11/18/87 18:28: 
ETVPKG  ESAPKG 70 25 11/18/87 rg7 
ETUPKG ESAPKG 70 24 11/18/87 2 5 
ESTPKG ~~ ESAPKG 11/18/87 18:27: 
ESRPKG  ESAPKG 11/18/87 18:26: 
ESFPKG  ESAPKG 11/18/87 18:26: 
copyfile / eg2pkg = a 11/18/87 18:25: 
ESEPKG ~~ ESAPKG 11/18/87 18:25: 
EUAPKG ESAPKG 11/18/87 18:24: 


— 


<a<_ ec ce ec ce xc <= 
eS i 


l= Help 2= Refresh 3= Quit 4= Sort(type) 5= Sort(date) 6= Sort(size) 
7= Backward 8= Forward 9= FL /n 10= 1ll= XEDIT 12= Cursor 


ao 


Figure 99. FILELIST of Package Definition Files 


3. Press PF2 (Refresh). 


4. To edit the new package definition file, place the cursor next to 
EG2PKG ESAPKG and press PF11 (XEDIT). 


5. Delete all but the following two records: 


*PACKAGE INSTALLED COMMAND EXEC ESAQA &01 
*COMPONENT IDS ESD ESI ETZ 
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6. Edit the “COMPONENT _IDS line to show only the EG2 code. The 
final record in the package definition file becomes: 


*COMPONENT IDS EG2 
7. Type: 
file 
on the command line, and press ENTER. 


8. Press PF3 (Quit) to leave the filelist. 
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Creating the Question and Answer File 


When you package your own application, you create a Question and 
Answer file. Whenever you run the PFSETUP EXEC, you are asked a 
question such as: 


EGO101I Do you want to include your own packaged application 
in the menus? 


Note: By answering this question, you include or exclude a 
packaged application and all the panels associated with it. 


To create the question and answer file for the CADAM application, 
use the question and answer file for the Text/Office System Package 
(ESFPKG NLSESAQA) as a model. 


1. Type: 


filelist * nlsesaqga * 
on the command line, and press ENTER. 


2. TO make a copy of this file for the CADAM application, type: 
copyfile / eg2pkg = a 


next to the ESFPKG NLSESAQA file, and press ENTER. 


Chapter 6. Adding and Packaging an Application 145 


3. Press PF2 (Refresh). 


4. Edit the EG2PKG NLSESAQA file to delete the copyright notice, 
change the text of the package installed question, and change the 


text following the “HELP_TEXT code and the “QUESTION code. 


Note: The “HELP TEXT code identifies lines of text that are 
displayed when the user types HELP in response to the 
question. 


After your changes, the file might look like this: 
The following message is displayed to the user. 
The question will be repeated until the user response 


matches either *YES, *NO or *QUIT as specified below. 


*QUESTION EG2101I Is CADAM installed? 
*QUESTION Answer Y, N, HELP, or QUIT. 


The initial answer to the question. 


If this matches either *YES, *NO, or *QUIT as specified 
below, then the question will not be asked. 


*ANSWER 


Figure 100 (Part 1 of 2). EG2PKG NLSESAQA file 
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The text which appears when help is requested. 


*HELP_TEXT &99 

*HELP_TEXT If you have installed CADAM 

*HELP TEXT then answer Y to include the home panel and 

*HELP_TEXT introduction dialog entries which support this package. 
*HELP_ TEXT &99 

*HELP TEXT If you answer N, then these entries will be omitted. 


The tokens to be used for yes, no, quit and help. 


*YES: “¥ 

*NO on 

*QUIT quit 

*HELP help 

Figure 100 (Part 2 of 2). EG2PKG NLSESAQA file 


The “YES, *NO, *QUIT, and *HELP codes indicate the valid 
responses the user may enter to answer your question. Leave 
these lines unchanged. The &99 is a code used to generate a 
blank line. 


5. Type: 
file 
on the command line, and press ENTER. 


You have finished adding and packaging the application. 


If you want to add online help panels for your application, go to 
Chapter 7, “Adding Online Help Panels” on page 149. 


If you want to add an introduction topic for your application, go to 
Chapter 8, “Adding an Introduction Topic” on page 161. 
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If you do not want to add online help or an introduction, go straight to 
Chapter 9, “Rebuilding, Testing, and Saving Your Tailored Menus” 
on page 187. 
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Chapter 7. Adding Online Help Panels 


The Advanced Tailoring chapters fit together as follows: 


e Chapter 6 shows how to add an application. 
¢ Chapter 7 shows how to add online help panels for the 


application. 


¢ Chapter 8 shows how to add an introduction topic for the 


application. 


Once you have added the application, the help panels, and the 
introduction topic, you should rebuild, test, and save the panels, as 


described in chapter 9. 
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This chapter shows you how to add an online Help panel to an 
application. Help panels should help the user make the right menu 
selection. 


This chapter discusses: 


e Creating a Help Panel 
e Creating a Flow file to display the Help panel 
e Adding the name of the Help flow file to the item file. 


This chapter shows, as an example, how you would add online help 
to CADAM. You would follow the same steps to add help to any 
application. 


To do the examples in this chapter, you must have read access to 
the 322 and 326 minidisks. To get read access, enter the following 
commands: 


access 322 0o/o 
access 326 n/n 
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Creating a Help panel 


The following instructions show you how to create the ISPF Help 
panel EG2CADH1 COPY. In this part of the example you: 


e Copy and rename a sample file from the O disk 
e Add Help information 

e Create a panel library 

e Store the Help panel in the library. 
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Copying and Renaming a Sample File 


To copy the sample file ESADHLP PANEL from the O disk and create 
your new Help panel file EG2CADH1 COPY, enter the following CMS 
command: 


copyfile esadhlp panel o eg2cadhl copy a 


(See “Help Panels” on page 210 for the naming conventions for Help 
panels.) 


Adding Help Information 


Use XEDIT to modify your Help panel to include a paragraph or two 
explaining what CADAM its, and what kinds of functions it can 
perform to help in your design work. The complete file is shown in 
“A Sample ISPF Help Panel File” on page 153. Modify the file where 
it currently has text following lines starting with a $. 


When you edit this ISPF panel, change only the narrative text and 
follow these rules: 


¢ Do not modify any special control characters or ISPF code while 
editing this file. 


¢ Do not add or delete any lines except the copyright statement at 
the top of the file and the specification information at the bottom 
of the file. Do not change any lines that begin with the ) or “right 
parenthesis” character. 


e Change only the narrative text. This is the text that appears 
following the )BODY command, and before the second line of 
dashes. (The text you can modify is shown highlighted in the 
figures.) 


¢ Do not change or delete the existing $ characters. 
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e The text you place there should not include any of the following 
special characters: 


_#+!§ 


4¢@7 


(These are used as ISPF attribute characters.) 


When you have finished modifying this file, ensure that the ISPF line 
numbers are off by entering the following commands on the XEDIT 
command line: 


set serial off 


and save the file with the following command: 


file 


Notes: 


1. Before you issue the FILE command to save your changes, you 
must issue the set serial off command on the XEDIT command 
line; otherwise, ISPF may not be able to display your panel. If 
you forget to enter this command, you may need to erase your 
file and start again. 


2. Whenever you edit a file that has filetype COPY, be sure to type 
set trunc 80 0n the XEDIT command line. (Otherwise, your file 
will be truncated at column 72.) 


The following is the sample ISPF Help panel ESADHLP PANEL. You 
can delete the specifications section from the end of the file. The 
section starts with the record: 


J Pe ER teen START-OF-SPECIFICATIONS a a ad 


and ends with the following record: 


PRR nee FND-OF-SPECIFICATIONS a | 
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A Sample ISPF Help Panel File 


YATTR 

/* COPYRIGHT: 5664-283 (C) COPYRIGHT IBM CORP 1984, 1985, 1987, 1988 */ 
/* LICENSED MATERIAL - PROGRAM PROPERTY OF IBM */ 
/* REFER TO COPYRIGHT INSTRUCTIONS FORM NUMBER G120-2083. */ 


TYPE( INPUT) INTENS(HIGH) CAPS (OFF) ee 


# TYPE(INPUT) INTENS(HIGH) CAPS(ON) 
+ TYPE(INPUT) INTENS(HIGH) CAPS(ON 
! TYPE(QUTPUT) INTENS(LOW) CAPS( 
$ TYPE(TEXT)  INTENS(LOW) CAPS (OFF 
TYPE(TEXT) = INTENS(HIGH) CAPS (OFF 
% TYPE(TEXT)  INTENS(LOW) CAPS (OFF 
TYPE(TEXT) INTENS(LOW) CAPS (OFF 
( ( 


¢ 

@ TYPE(QUTPUT) INTENS(HIGH) CAPS(OFF 

> TYPE(INPUT) INTENS(HIGH) CAPS (ON) 
)BODY CMD(ZCMD) SMSG(LMSG) LMSG(LMSG) 


Figure 101 (Part 1 of 5). The ISPF Help panel 


) 
OFF) SKIP 


ATTN(ON 
ATTN(ON) 
/* Message output hilighted */ 


) /* Mixed data input | 
) /* Upper data input =) 
/* Mixed text input a 


ON) /* Mixed text output */ 
ON 


) /* Mixed text */ 
ON) /* Hilighted text */ 
) /* Lightpen text */ 
/* PF Key pads) */ 


/* Command line input */ 
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SF 


The Help information that you requested is not available 
and some of the reasons are listed below. 


Help panels are provided for all the products and functions 
shipped; you may be requesting Help for a service that is 
not shipped. Help of this type is provided by your system 
administrator. 


You may have asked for Help from the Online Introduction. 
Help is not provided because the introductory information 
is very detailed. 


If you are already viewing a Help panel, you cannot 
request more Help information. 


Fr rm wr Hr OH OO HH OO OH HO HH HTH HH OH OH 


$PF: 1¢ &ZPF13 $2¢ &ZPF14 $3¢ &ZPF15 $4¢ &ZPF16 $5¢ &ZPF17 $6¢ &ZPF18 $ 
$PF: 7¢ &ZPF19 $8¢ &ZPF20 $9¢ &ZPF21 $10¢ &ZPF22 $11¢ &ZPF23 $12¢ &ZPF24 $ 


Figure 101 (Part 2 of 5). The ISPF Help panel 
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@LMSG 
| ===>>ZCMD $ 
) INIT 
/*&ZCMD = '' */ /* retrieve will set ZCMD. */ /* QVJOPFRX */ 
&ZPFO1 = '...' /* Disable the help key */ 


/* @NLS 'Backward','Forward','End','Return','Probrep','Retrieve' */ 


= 


mF 


nPmREUnenreA DB 


Hm PR 


&ZPFO2 = 


&ZPFO3 
&ZPFO4 
&ZPFO5 
&ZPFO6 
&ZPFO7 
&ZPFO8 
&ZPFO9 
&ZPFI1O 
&ZPF11 
&ZPF12 
&ZPF13 
&ZPF14 
&ZPF15 
&ZPF16 
&ZPF17 
&ZPF18 
&ZPF19 
&ZPF20 
&ZPF21 
&ZPF22 
&ZPF23 
&ZPF24 


“End! 
‘Return ' 
'CMS' 

1G! 
'Backward' 
‘Forward! 
‘Probrep' 


/* Set the Backward key */ 
/* Set the Forward key */ 


‘Retrieve! 
&ZPFO1 
&ZPFO2 
&ZPFQO3 
&ZPFO4 
&ZPFO5 
&ZPFO06 
&ZPFO/ 
&ZPFO8 
&ZPFO9 
&ZPF10 
&ZPF11 
&ZPF12 


Figure 101 (Part 3 of 5). The ISPF Help panel 
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VPUT (ZPFO1 ZPFO2 ZPFO3 ZPFO4 ZPFQ5 ZPFO6 ZPFO7 ZPFO8 ZPFO9) PROFILE 
VPUT (ZPF10 ZPF11 ZPF12 ZPF13 ZPF14 ZPF15 ZPF16 ZPF1/ ZPF18) PROFILE 
VPUT (ZPF19 ZPF20 ZPF21 ZPF22 ZPF23 ZPF24) PROFILE 
) PROC 
[REELED EEERE ELA AE SON RL eR AACE RR em NN aT ee om Men ene Rema 
/* Control panel flow by setting the shared variables required by a 
/* ESAFM MODULE. i 
Ya 
/* Check that the command entered is valid, look at first word only. */ 
&CMD = TRUNC(&ZCMD,' ') 
IF (.RESP = END) &CMD = *END 


/* @NLS 'BACKWARD', 'FORWARD', 'RETRIEVE' */ 
&VALIDCMD = TRANS(&CMD 
*END ,*END ' ' FORWARD ' 
'FORWARD', 'FORWARD' 'BACKWARD', 'BACKWARD' 
'RETRIEVE', *RET /* @VJOPFRX */ 
* ,*CMS) /* QVJOPFRX */ 


/* Set the flow control shared variables based on the command. */ 
&ESAACTN = TRANS (&VALIDCMD 


‘FORWARD! , *F ‘BACKWARD! , *B 
*END Pais =CMS _— *RET »' ') /* @VJOPFRX */ 
/* Check for retrieve or pass command to CMS. */ /* @VJOPFRX */ 


&ESACMD = TRANS (&VALIDCMD 
*RET ,'EXEC ESARETRC' *CMS — ,'EXEC ESASECMD &ZCMD' /* @VJOPFRX */ 
7 ,' ') 

VPUT (ESAACTN ESACMD) SHARED 

) END 


Figure 101 (Part 4 of 5). The ISPF Help panel 
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FEE AL EE ROI START-OF-SPECIFICATIONS eA ett apne Magee cor ern ay) 


/* MODULE NAME: ESADHLP (VM/IS-Productivity Facility Release 5.1) */ 
/* FUNCTION: No help panel. x} 
/* NOTES: N/A */ 
/* ENTRY POINT: N/A */ 
/* INPUT: NONE */] 
/* OUTPUT: */ 
/* SHARED VARIABLES: */ 
f* ESAACTN Returned action for ESAFM MODULE. | 
/* EXIT NORMAL: N/A ua | 
/* EXIT ERROR: N/A a 
/* EXTERNAL REFERENCES: N/A oy 
/* TABLES: NONE */ 
/* MESSAGES: NONE */ 
/* DEVELOPMENT ACTIVITY: Feb 28 85 ny 
ol Text change. ee 
/* CHANGE ACTIVITY: None oy 


f REEL AA ERA END-OF-SPECIFICATIONS | 


Figure 101 (Part 5 of 5). The ISPF Help panel 


Creating a Library and Storing the Help Panel 


Before ISPF can display your new Help panel, you must put it into an 


ISPF panel library. The MACLIB command requires that your Help 
panel has a filetype of COPY, and the library has a filemode of A2. 


Create a panel library named EG2PLIB for your Help panel with the 


following CMS commands: 


maclib gen eg2plib eg2cadhl 
rename eg2plib maclib a = = a2 


If you already have a panel MACLIB for your application, copy it to 
the A2 disk Instead of creating a new one. 
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See “File Naming Conventions” on page 212 for the naming 
conventions for ISPF panel libraries. See also 

Appendix D, “MACLIB Commands” on page 265 for a description of 
MACLIB commands. 


If you modify your EG2CADH1 COPY Help panel or a Help panel for 
your application, you can replace it in your panel library with the 
following CMS commands: 


maclib rep eg2plib eg2cadhl 
maclib comp eg2plib 


If you had created additional ISPF panels for the EG2 package, you 
could have added each of them to your panel library with the 
following CMS command: 


maclib rep eg2plib EG2xxxxx 
where EG2xxxxx is the name of an additional ISPF panel. 


Note: If EG2xxxxx already exists in the library, the REP command 
replaces it with the current ISPF panel of that name. If 
EG2xxxxx does not exist in the library, a message is issued to 
indicate that this is the first time you are adding it to the 
library. 


Once you have added all the panels to the MACLIB, you compress 
the library. Type: 
maclib comp eg2plib 


on the command line, and press ENTER. 
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Creating a Flow File 


A flow file contains a list of commands used by the tailorable panels 
to display Help panels. This part of the example creates a flow file 
named EG2CADM ESAFLOW. It includes a record containing the 
command to display the CADAM Help panel. The ESAFM MODULE 
executes the command when the user selects Help for the CADAM 
topic from the GRAPHICS HELP menu. 


(See “Flow Files” on page 255 for a detailed description of the 
format of flow files and see “ESAFM Module’ on page 263 fora 
detailed description of ESAFM MODULE). 


To create the EG2CADM ESAFLOW file, enter the following 
command: 


x eg2cadm esaflow 


To specify the name of the Help panel you created, enter the 
following record: 


&SUBCOMMAND ISPEXEC DISPLAY PANEL(EG2CADH1) 
To save the flow file type: 
file 


on the command line, and press ENTER. 


eS SS Sa eS Ses Se, ee SS eee De ee ee eS CD Se eee 
Connecting Help to a Selectable Item 


The following instructions tell you how to edit the CADAM item file to 
include Help for CADAM. You created the EG2CADM ESAITEMA 
item file when you added CADAM to the GRAPHICS menu. That file 
contains the following records: 
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*DESCRIPTION TEXT Work with design drawings. 
*KEY PHRASE CADAM 

*COMMAND2 EXEC EG2CADM 

*HELP COMMAND ESAFM ESADHLP 


The ESAFM ESADHLP command displays a panel that indicates that 
Help is not available. To include Help for the CADAM item, change 
the “HELP COMMAND entry to: 


*HELP_COMMAND ESAFM EG2CADM 
(EG2CADM is the name of the flow file you created earlier.) 


To save the item file, type: 
file 


on the command line, and press ENTER. 
You have finished adding online help. 


If you want to add an introduction topic for your application, go to 
Chapter 8, “Adding an Introduction Topic” on page 161. 


If you do not want to add an introduction, go straight to 
Chapter 9, “Rebuilding, Testing, and Saving Your Tailored Menus” 
on page 187. 
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Chapter 8. Adding an Introduction Topic 


The Advanced Tailoring chapters fit together as follows: 


e Chapter 6 shows how to add an application. 

¢ Chapter 7 shows how to add online help panels for the 
application. 

¢ Chapter 8 shows how to add an introduction topic for the 
application. 


Once you have added the application, the help panels, and the 
introduction topic, you should rebuild, test, and save the panels, as 
described in chapter 9. 
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This chapter contains one example of adding an introduction topic. 
To do more complicated examples, you would need knowledge of 
ISPF. 


The example shows how to add online introduction information for 
the CADAM application that you added in previous examples. 
Specifically, the example shows how to add a topic named 
Mechanical Design to the INTRODUCTION TOPICS menu (ESIMAA1) 
immediately after the Graphics topic. When the user selects 
Mechanical Design from the INTRODUCTION TOPICS menu, the 
Mechanical Design subtopic selection menu will be displayed. 


From this panel you can go to: 


e A “try it” panel, from which the user can invoke your CADAM 
EXEC 


e Narrative panels, which display information about CADAM 


e Example panels, which show examples of CADAM designs. 


Note: Instead of creating a new topic for CADAM, you could add the 
CADAM subtopic to an existing topic, such as Graphics. 


The instructions in this chapter show you how to: 


1. Add the Mech-design topic to the INTRODUCTION TOPICS menu 
2. Create the Mech-design subtopic selection menu 
3. Create the ISPF panels for a subtopic selection. 


Before you begin, you must choose a unique three-character 
component code for your online introduction topic. Except for the 
files you create in this example, no other files on your system should 
have file names that start with these three characters. 


Tailoring Your Menus 


In this example, EG3 represents the unique component code you 
choose for your topic. All of the files you create in this example start 
with this component code. EG3 is used instead of EG2 to distinguish 
Introduction menu tailorings from Home menu tailorings. 


To do the examples in this chapter, you must have read access to 
the 322 and 326 minidisks. To get read access, enter the following 
commands: 


access 322 o/o 
access 326 n/n 


ee ie a ie ean oe PR Ae Ee Pe ee 
Adding the Topic 


In the previous example (“Creating the Package Definition File” on 
page 143), you created a package definition file named EG2PKG 
ESAPKG that added CADAM, a mechanical design program, to the 
PF menus. By modifying this package definition file, you can also 
use it to include your Mechanical Design introduction topic in the 
PF’s online introduction. 


Follow these editing instructions to add your new Mechanical Design 
topic to the INTRODUCTION TOPICS menu: 


1. Edit your EG2PKG ESAPKG package definition file. 


Add your component code EG3 to the “COMPONENT IDS record 
of the EG2PKG ESAPKG panel definition file. This file should 
now contain the following two records: 


*PACKAGE INSTALLED COMMAND EXEC ESAQA &01 
*COMPONENT IDS EG2 £G3 


(See “Panel Definition Files” on page 233 for a detailed 
description of the format of package definition files.) 
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Because you are using the same package definition file, you do 
not need to create another question and answer file. (PFSETUP 
will use the EG2PKG NLSESAQA question and answer file.) 


. Look at the INTRODUCTION TOPICS slot request file (ESI 


ESASRINS). 


Slot request files define which tailoring files apply to which 
panel, and the order in which they are applied. See ‘Slot 
Request Files” on page 223 for a detailed description of the 
format of slot request files. 


Find the slot request records for the Graphics introduction menu 
(ESICGA1): 


Ss 100 esimaal esigraph 1700 esichart esaitema 
S 100 esimaal esispaca 2000 esispace esahead 


Note: The sort order number for the Graphics topic is 1700, and 
the sort order number for the blank line that follows it is 
2000. You must know this information to insert your new 
Mechanical Design topic after the blank line that follows 
the Graphics topic. 


. Create a slot request file named EG3 ESASRIN$. 


The file you create should contain the following records: 


5; 100 esimaal eg3mec 2400 eg3mec esaitema 
s 100 esimaal eg3spacb 2500 eg3space esahead 


(See “Slot Request Files” on page 223 for a detailed description 
of the format of slot request files.) 


This record will add your new item file EG3MEC ESAITEMA anda 
blank line to the ESIMAA1 panel definition file. Because the sort 
order numbers are higher than 2000, the Mechanical Design topic 
will appear on the INTRODUCTION menu after the Graphics topic. 


Note: If you have added other applications, they may appear 
between your selection and Graphics. 
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4 Create an item file named EG3MEC ESAITEMA. 


This is the item file you specified in your slot request record. It 
contains the information to be included for the Mechanical 
Design topic on the INTRODUCTION menu. The file you create 
should contain the following records: 


*DESCRIPTION TEXT Using Computer Graphics. 
*KEY PHRASE Mech-design 
*COMMAND ESAFM EG3MEC 


The text “Mech-design” and “Using Computer Graphics” will 
appear beside a selection number on the Introduction menu. 
When this number is selected, the command ESAFM EG3MEC 
will be executed. 


(See “Content Item Files” on page 244 for a detailed description 
of the format of item files.) 


5. Create a flow file named EG3MEC ESAFLOW. 


This is the flow file you specified on the “COMMAND record of 
your EG3MEC ESAITEMA item file. This flow file contains 
commands to display the narrative and example selection !ist. 
The file you create should contain the following records: 

ESADM EG3MEC10 

&SUBCOMMAND ISPEXEC DISPLAY PANEL(EG3MEC2) 

The first command will display the subtopic selection menu that 
you create in the next section. The second command will display 


the ISPF panel you create in the “Creating the ISPF Panels” 
section. 


(See “Flow Files” on page 255 for a detailed description of the 
format of flow files.) 


6. Create the EG3SPACE ESAHEAD file. 


Enter the following CMS command: 


copyfile esispace esahead o eg3space = a 
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Edit the EG83SPACE ESAHEAD file and remove the copyright lines 
at the top of the file. 


This file produces the blank line that separates selections on the 
introduction menu. 


Co) ee ae RAE ST ee ER Cas a epee ee 
Creating the Subtopic Selection Menu 


To create the files for building the subtopic selection menu: 


1. Add records to your EG3 ESASRIN$ slot request file. 
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You created this slot request file when you added the Mechanical 
Design item to the INTRODUCTION TOPICS menu. Now you must 
add the records that create a panel definition file for your new 
logical panel EG3MEC1. 


Add the following records to your EG3 ESASRIN$ slot request 
file: 
* MECH SUBTOPIC-SELECTION MENU. 


S 100 EG3MEC1 *TITLE 000 EG3MEC1 ESATITLE 
S 100 EG3MEC1 EG3CAD 100 EG3CAD ESAITEMA 


(See “Slot Request Files” on page 223 for a detailed description 
of the format and naming conventions of slot request files.) 


Notice that the first slot request name (*TITLE) does not start with 
your component code EG3. Because every logical panel has only 
one title, this slot request name is standard. You must use it. 


The last slot request record adds an item file for CADAM to your 
subtopic selection menu. The name of this slot request starts 
with your component code EG3. 
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2. Create a title item file named EG3MEC1 ESATITLE. 


This is the file you specified in your *TITLE slot request record. It 
contains the title and control information for your logical panel 
EG3MEC1. (See “Title Item Files” on page 236 for a detailed 
description of the format of title item files.) 


The file you create should contain the following records: 


*LONG PANEL_INFO ESAINT 18 *NOPAGE 


*TITLE_TEXT 
*TITLE_ TEXT 
*TITLE TEXT 
*TITLE_TEXT 
*TITLE TEXT 
*TITLE TEXT 
*TITLE_TEXT 
*TITLE_TEXT 
*TITLE_TEXT 
*TITLE TEXT 
*TITLE TEXT 


*TITLE TEXT Applications 


*TITLE TEXT 
*MORE_TEXT 
*OFFSET 13 


What is 
Mechanical 
Design? 
&99 

Skill Level 
Required 


&99 
Available 


&99 


MECHANICAL DESIGN Page 1 of 2 
PeCHENIOG) DESTON IAC IWERS. ccescrc eewesaew ieee eee anae nae 
s ieianeede dene dice (Provide a general description here.) ........ 


*esesenvrpeenweeeeeseeseeeeeervr_iereeveeereseaseenvreevpeseeeeases eee 


No programming experience is required for you to ......... 
MUPURIT ITT CITT Pere Tr For the skilled programmer, 
(You may want a paragraph such as this) ... 


eeeweemeoee eee eeeweeetmaeaeeeveeeereeeaeeenewneeeeeerseeseee 


Choose from the subtopics below to find out more about 
the graphic products available: 


!| (Continued... Press PF8) 


Note: You may find it helpful to use an existing title item file, 
such as the Graphics title item file ESICGA1 ESATITLE, as 
a mode! when you create this file. 


Notice that the title text is more than one line long. If you ever 
add enough subtopics to your EG3MEC1 menu to cause it to 
require more than one physical panel, the entire title will be 
repeated at the top of each subsequent physical panel for this 


menu. 
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3. Create a content item file named EG3CAD ESAITEMA. 


This is the file you specified in your EG3CAD slot request record. 
It contains the information for the (CADAM) subtopic selectable 
item. (See “Content Item Files” on page 244 for a detailed 
description of the format of content item files.) 


The file you create should contain the following records: 


*DESCRIPTION TEXT Using CADAM for computer graphics. 
*KEY PHRASE CADAM 
*COMMAND ESAFM EG3CAD 


. Create a flow file named EG3CAD ESAFLOW to display the 


CADAM subtopic narrative unit. 


This is the flow file you specified in the “COMMAND record of 
your EG38CAD ESAITEMA item file. The commands you put in 
this flow file will be executed when the user selects the CADAM 
subtopic from the Mechanical Design subtopic selection menu 
(EG3MEC1). (See “Flow Files” on page 255 for a detailed 
description of the format of flow files.) 


The file you create should contain the following records: 


&SUBCOMMAND ISPEXEC DISPLAY PANEL(EG3CAD1) 


&SUBCOMMAND ISPEXEC DISPLAY PANEL(EG3CAD2 ) 


You create the panels that these two records specify later. If you 
had more information about CADAM than would fit on two panels, 
you could add additional records to this flow file to display them. 
You would name your additional panels EG3CAD3, EG3CAD4, 
and soon. 
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Creating the ISPF Panels 


You have created the tailoring files to include the Mechanical Design 
topic in the online introduction. You must still create the ISPF panels 
specified in your flow files. 
You have created the following flow files: 
¢ EG3MEC ESAFLOW - the Mechanical Design topic narrative unit 
¢ EG3CAD ESAFLOW - The CADAM subtopic narrative unit. 
The EG3MEC flow file specifies the following ISPF panels: 
¢ EG3MEC10 and EG3MEC2 - The Mechanical Design narrative 


unit. 


Note that EG3MEC10 will be built by PFSETUP, as specified in the 
EG3 ESASRINS$ file. 


The EG3CAD fiow file specifies the following ISPF panels: 
¢ EG38CAD1 and EG3CAD2 - The CADAM subtopic narrative unit. 


As you will see, the EG3MEC2 panel lets the user select from a list of 
example panels. This list contains the following: 

¢ EG3MDX1 - The CADAM example panel. 
Follow these instructions to create the ISPF panels: 


1. Create the EG3MEC2 panel. 


This is the “try it” panel you specified in your flow file EG3CAD 
ESAFLOW. 
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Because it is similar, use panel ESIPDA2 as a model for your 
new panel. Enter the following CMS command: 


copyfile esipda2 panel o eg3mec2 copy a 
to create your new “try it” panel file EG3MEC2 COPY. 


Use XEDIT to modify the )BODY section of the EG3MEC2 COPY 
file. You must also modify the three lines that let the user 
execute the CADAM EXEC. 


Notes: 


a. Before you issue the FILE command to save your changes, 
you must issue the set serial off command on the XEDIT 
command line; otherwise, ISPF may not be able to display 
your panel. If you forget to enter this command, you may 
need to erase your file and start again. Figure 102 shows the 
panel you should create. 


b. Whenever you edit a file that has filetyoe COPY, be sure to 
type set trunc 80 on the XEDIT command line. (Otherwise, 
your file will be truncated at column 72.) 


YATTR 
TYPE( INPUT) INTENS(HIGH) CAPS(OFF) PAD(_) /* Mixed data input a i 
TYPE(INPUT) INTENS(HIGH) CAPS(ON) PAD( () /* Upper data input ad 
TYPE(INPUT) INTENS(HIGH) CAPS (ON) /* Mixed text input ce 
TYPE(OUTPUT) INTENS(LOW) CAPS(OFF) SKIP(ON) /* Mixed text output */ 
TYPE(TEXT) INTENS(LOW) CAPS(OFF) SKIP(O /* Mixed text */ 

( ( ( 

( ( ( 

( ( ( 


Se a a 


) ( 
) (ON) 

TYPE(TEXT) | INTENS(HIGH) CAPS(OFF) SKIP(ON) /* Hilighted text */ 
TYPE(TEXT) | INTENS(LOW) CAPS(OFF) ATTN(ON) § /* Lightpen text */ 
) 

) 

) 


of 


¢ TYPE(TEXT) INTENS(LOW) CAPS(OFF) ATTN(ON) /* PF Key pads */ 

@ TYPE(OUTPUT) INTENS(HIGH) CAPS(OFF) /* Message output hilighted */ 

— TYPE(INPUT) INTENS(HIGH) CAPS (ON /* Command line input */ 
)BODY CMD(ZCMD) SMSG(LMSG) LMSG(LMSG) 


Figure 102 (Part 1 of 4). The CADAM Try It panel 
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$ MECHANICAL DESIGN 

ee ek ee ee eee eee aie ee re eerie 
$Try It CADAM is available from the Graphics menu, 

$ or you can try it now by choosing the following: 

$ 

% 1 CADAM Use mechanical design. 

$ 

$ When you have finished, press the END key to return here. 
$ 

$ 

$ 

$End of This is the end of the Mechanical Design topic. 

$Topic 

$ Press the: 

$ 

$ FORWARD key to proceed to the next topic, or the 

$ 

$ END key to return to the Introduction Topics menu. 

$ 


$PF: 1¢ &ZPF13 $2¢ &ZPF14 $3¢ &ZPF15 $4¢ &ZPF16 $5¢ &ZPF17 $6¢ &ZPF18 $ 
$PF: 7¢ &ZPF19 $8¢ &ZPF20 $9¢ &ZPF21 $10¢ &ZPF22 $11¢ &ZPF23 $12¢ &ZPF24 $ 
@LMSG 
| ===> ZCMD $ 
) INIT 

&ZPRIM = NO /* This is not a primary option menu. as 
) PROC 


Figure 102 (Part 2 of 4). The CADAM Try It panel 
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/* @NLS note: The following items specified in single quotes =) 
ye should be translated. | 


i | 


&CADAM = 'CADAM' 


ROGER PARES ERE eee eee ee eee ee ee a ees eae ep 


/* Control panel flow and command execution by setting a | 
/* the shared variables required by the ESAFM MODULE. as 


i a | 


/* Check that the command entered is valid */ 


&CMD = TRUNC(&ZCMD,' ') /* Look at only the first word. */ 
IF (.RESP = END) 

&CMD = *END 
&VALIDCMD = TRANS (&CMD 

*END »*END » OE SES TCOMPOR* 


"RESICMFOR' ,'&ESICMFOR' '&ESTCMBAC' ,'&ESTCMBAC' 
‘BESTCMNEX' 5 '&ESTCMNEX' '&ESICMPRE', '&ESTCMPRE ' 


l J 1 "&CADAM' | ] 
"SESITCMRET' S*RET 
* SCMS) 


Figure 102 (Part 3 of 4). The CADAM Try It panel 
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/* Set the flow control shared variables based on the command */ 


BESAACTN = TRANS (&VALIDCMD 

'&ESTCMFOR' ,*F '&ESTCMBAC' ,*B 

‘&ESICMNEX', *N '&ESICMPRE! ,*P 

*END JE *CMS - *RET %) 
BESACMD = TRANS (&VALIDCMD 

1 ,'EXEC ESAPFCP * ESATRYIT CADAM' 

*RET "EXEC ESARETRC' *CMS "EXEC ESASECMD &ZCMD' 

i , ') 


VPUT (ESAACTN,ESACMD) SHARED 


Figure 102 (Part 4 of 4). The CADAM Try It panel 


The parts you changed are shown highlighted. Do not modify any 
other parts of this panel, and do not add or delete any lines, 
except the copyright statement at the top of the file and the 
specification statement at the bottom of the file. The text you add 
must not include any of the following special characters: 


_#4+1$ 


4¢@7 


When you have finished modifying this file, enter the following 
commands on the XEDIT command line: 

set serial off 

fj le 


Before ISPF can display your new panel, you must put it into an 
ISPF panel library. You should put the ISPF panels you create in 
the ISPF panel library EG2PLIB MACLIB. As a result, you will 
have only one panel library to contain all the ISPF panels for 
your package. 


If you have not already created the EG2PLIB MACLIB, create it 
now. For more information, see “Creating a Library and Storing 
the Help Panel” on page 157 or Appendix D, “MACLIB 
Commands” on page 265. 
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Enter the following CMS commana: 


maclib rep eg2plib eg3mec2 


to put your EG3MEC2 panel into your ISPF panel library EG2PLIB 
MACLIB. 


Note: If EG3MEC2 already exists in the library, this command 
replaces it with the current ISPF panel of that name. lf 
EG3MEC2 does not exist in the library, a message is 
issued to indicate this fact. Just ignore the message. 


. Create the EG3CAD1 panel. 


This is the first page of the Mechanical Design subtopic narrative 
unit. The text you put on this panel should describe what CADAM 
is used for, and what the user can expect to accomplish by using 

it. 

Because it is similar, use panel ESITXB6 as a model for your new 
panel. Enter the following CMS command: 


copyfile esitxb6 panel o eg3cadl copy a 
to create your narrative panel file EG3CAD1 COPY. 


Use XEDIT to modify the )BODY section of the EG3CAD1 COPY 
file. Figure 103 shows the panel you should create. 


Note: Whenever you edit a file that has filetyoe COPY, be sure to 
type set trunc 80 on the XEDIT command line. (Otherwise, 
your file will be truncated at column 72.) 
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\ATTR 
_ TYPE( INPUT) INTENS(HIGH) CAPS(OFF) PAD(_) /* Mixed data input a A 
# TYPE(INPUT) INTENS(HIGH) CAPS(ON) PAD(_) /* Upper data input a 
+ TYPE(INPUT) INTENS(HIGH) CAPS(ON) /* Mixed text input ay A 
! TYPE(OUTPUT) INTENS(LOW) CAPS(OFF) SKIP(ON) /* Mixed text output */ 
$ TYPE(TEXT) INTENS(LOW) CAPS(OFF) SKIP(ON /* Mixed text */ 
( ( ( 
( ( ( 
( ( ( 


) ( 

) (ON) 

TYPE (TEXT) INTENS(HIGH) CAPS(OFF) SKIP(ON) /* Hilighted text */ 
TYPE (TEXT) INTENS(LOW) CAPS(OFF) ATTN(ON) /* Lightpen text */ 
TYPE (TEXT) INTENS(LOW) CAPS(OFF) ( 

TYPE(QUTPUT) INTENS(HIGH) CAPS(OFF) 

— TYPE(INPUT) INTENS(HIGH) CAPS(ON) 

)BODY CMD(ZCMD) SMSG(LMSG) LMSG(LMSG) 


Figure 103 (Part 1 of 3). Page 1 of the CADAM Subtopic Narrative unit 


ATTN(ON) /* PF Key pads */ 
/* Message output hilighted */ 
/* Command line input = */ 


Qa 
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$ CADAM Page 1 of 2 


$ CADAM CADAN «6 vce s seaneeeeucacese 
$ 


(Place a description of CADAM here.) 


FAA HA FH HF HK HF FH HH HH OH HF 


$PF: 1¢ &ZPF13 $2¢ &ZPF14 $3¢ &ZPF15 $4¢ &ZPF16 $5¢ &ZPF17 $6¢ &ZPFI8 $ 
$PF: 7¢ &ZPF19 $8¢ &ZPF20 $9¢ &ZPF21 $10¢ &ZPF22 $11¢ &ZPF23 $12¢ &ZPF24 $ 
@LMSG 
| ===> ZCMD 
) INIT 

&ZPRIM = NO /* This is not a primary option menu. | 
) PROC 


Figure 103 (Part 2 of 3). Page 1 of the CADAM Subtopic Narrative unit 
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BHReOBEeeEge@euzgSeSBeHeeeaeEBaHe B BS 


a | 


/* Control panel flow and command execution by setting */ 
/* the shared variables required by the ESAFM MODULE. ny 


[PLEASE LES ER CAE AYE he heheh Se Nn Re age me aw Ren MO ha en np 


/* Check that the command entered is valid */ 


&CMD = TRUNC(&ZCMD,' ') /* Look at only the first word. */ 
IF (.RESP = END) 

&CMD = *END 
&VALIDCMD = TRANS (&CMD 

*END » *END ' ' S'&ESTCMFOR' 


‘BESTCMFOR' ,'&ESICMFOR' '&ESTCMBAC' , ‘&ESTCMBAC' 
'RESTCMNEX' ,'&ESTCMNEX' '&ESTCMPRE' , '&ESTCMPRE' 
'RESTCMRET ' , *RET 

*=CMS) 


/* Set the flow control shared variables based on the command */ 


&ESAACTN = TRANS (&VALIDCMD 


“BESICMFOR™ °F ‘&ESTCMBAC' ,*B 
'BESTCMNEX' ,*N ‘&ESTCMPRE' , *P 
*END 5 E *CMS _ RET — * 


&ESACMD = TRANS (&VALIDCMD 
*RET 9” EXEC ESARETRC* “CMS » EXEC ESASECMD &ZCMD' 
7 2 |) 

VPUT (ESAACTN ESACMD) SHARED 

) END 

Figure 103 (Part 3 of 3). Page 1 of the CADAM Subtopic Narrative unit 


The parts you should change are shown highlighted. Do not 
modify any other parts of this panel, and do not add or delete any 
lines, except the copyright statement at the top of the file and the 
specification statement at the bottom of the file. The text you add 
must not include any of the following special characters: 


_#+1$/[%¢0 
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When you have finished modifying this file, enter the following 
commands on the XEDIT command line: 


set serial off 
file 


Enter the following CMS command: 
maclib rep eg2plib eg3cadl 


to put your EG3CAD1 panel into your ISPF panel library EG2PLIB 
MACLIB. 


. Create the EG3CAD2 panel. 


This is the second page of the CADAM subtopic narrative unit. In 
addition to displaying narrative text, it allows the user to display 
an example of a report produced by CADAM. 


Because it is similar, use panel ESITXB7 as a model for your new 
panel. Enter the following CMS command: 


copyfile esitxb/ panel o eg3cad2 copy a 
to create your narrative panel file EG3CAD2 COPY. 


Use XEDIT to modify the )BODY section of the EG3CAD2 COPY 
file. You must also modify the three lines that let the user see 
your example panel EG3MED1. Figure 104 shows the panel you 
should create. 


Note: Whenever you edit a file that has filetype COPY, be sure to 
type set trunc 800n the XEDIT command line. (Otherwise, 
your file will be truncated at column 72.) 
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BP HESBSEEBSEHESBSEeEaESa EB B 


)ATTR 

_ TYPE(INPUT) INTENS(HIGH) CAPS(OFF) PAD(_) /* Mixed data input is | 
# TYPE(INPUT) INTENS(HIGH) CAPS(ON) PAD(_) /* Upper data input af 
+ TYPE(INPUT) INTENS(HIGH) CAPS(ON) /* Mixed text input uz 4 
! TYPE(OUTPUT) INTENS(LOW) CAPS(OFF) SKIP(ON) /* Mixed text output */ 
$ TYPE(TEXT) INTENS(LOW) CAPS(OFF) SKIP(ON) /* Mixed text */ 

TYPE (TEXT) INTENS (HIGH) CAPS(OFF) SKIP(ON) /* Hilighted text */ 
% TYPE(TEXT) INTENS(LOW) CAPS(OFF) ATTN(ON) /* Lightpen text > 
¢ TYPE(TEXT) INTENS(LOW) CAPS(OFF) ATTN(ON) /* PF Key pads ry 
@ TYPE(OQUTPUT) INTENS(HIGH) CAPS(OFF) /* Message output hilighted ~*/ 


— TYPE(INPUT) INTENS(HIGH) CAPS(ON) /* Command line input = */ 


Figure 104 (Part 1 of 4). Page 2 of the CADAM Subtopic Narrative unit 
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)BODY CMD(ZCMD) SMSG(LMSG) LMSG(LMSG) 
$ CADAM Page 2 of 2 


$ CADAM (Continue your description here...... ) 
$continued... 


$ 
$ 
$ 


$ Examples Choose this example: 


oF 


oP 


1 Reportl An example of a CADAM report. 


Fr A FA OFF HOH OH 


BHREHE BE 


Ls 


$PF: 1¢ &ZPF13 $2¢ &ZPF14 $3¢ &ZPF15 $4¢ &ZPF16 $5¢ &ZPF17 $6¢ &ZPF18 $ 
$PF: 7¢ &ZPF19 $8¢ &ZPFZ20 $9¢ &ZPF21 $10¢ &ZPF22 $11¢ &ZPF23 $12¢ &ZPF24 $ 


@LMSG 
| ===> ZCMD 
YINIT 
&ZPRIM = NO /* This is not a primary option menu. 
) PROC 


Figure 104 (Part 2 of 4). Page 2 of the CADAM Subtopic Narrative unit 
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*/ 


a a 


BHEEE 


BPmROeRemPemrtenRrienRenRenReABaenrRrtinAenen a B&B 


[PASE LAER EAEA DERLAM RN ee ae eA Neenah Ron Rn Rm eee a ae eR 


/* NLS note: The following items specified in single quotes a7 
‘i should be translated. */ 


a a a | 


&REPORTI = 'REPORT1' 


JF OLE LAAA READ A Day ON ce Mate Mee tee eae aoe Pu VED FON Dem Welty ene gh ek eee ae ea epee eae a 


/* Control panel flow and command execution by setting gf 
/* the shared variables required by the ESAFM MODULE. af | 


AE SCO Pe eins Sine AC ena AN RR Pe DN a ae he MnO ene nt ee Fe 


/* Check that the command entered is valid */ 


&CMD = TRUNC(&ZCMD,8) /* Look at only the first 8 char*/ 
IF (.RESP = END) 
&CMD = *END 
&VALIDCMD = TRANS (&CMD 
*END , *END ' ' '&ESTCMFOR' 


'RESTCMFOR','&ESICMFOR' '&ESTCMBAC','&ESTCMBAC' 
"BESTCMNEX' ,'&ESTCMNEX' ‘&ESTCMPRE','&ESTCMPRE' 


| 5. ok ‘&DOCUMENT' , 1 
‘RESTCMRET' ,*RET 
ae! Se 


Figure 104 (Part 3 of 4). Page 2 of the CADAM Subtopic Narrative unit 
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/* Set the flow control shared variables based on the command */ 


&ESAACTN = TRANS (&VALIDCMD 


'BESTCMFOR' , *F '&ESTCMBAC' ,*B 

'&ESTCMNEX' , *N '&ESTCMPRE' ,*P 

*END rele *CMS - *RET sy 
&ESACMD = TRANS (&VALIDCMD 

1 » &&SUBCOMMAND ISPEXEC DISPLAY PANEL(EG3MDX1) ' 


*RET ,'EXEC ESARETRC' *CMS — ,'EXEC ESASECMD &ZCMD' 
E s ') 

VPUT (ESAACTN, ESACMD) SHARED 

) END 


Figure 104 (Part 4 of 4). Page 2 of the CADAM Subtopic Narrative unit 


The parts you should change are shown highlighted. Do not 
modify any other parts of this panel, and do not add or delete any 
lines, except the copyright statement at the top of the file and the 
specification statement at the bottom of the file. The text you add 
must not include any of the following special characters: 


_#+1$]%¢07 


When you have finished modifying this file, enter the following 
commands on the XEDIT command line: 


set serial off 
file 


Enter the following CMS command: 
maclib rep eg2plib eg3cad2 


to put your EG3CAD2 panel into your ISPF panel library EG2PLIB 
MACLIB. 


4. Create the EG3MDX1 panel. 


This is the example panel for your CADAM subtopic. On this 
panel, you put an example of a report produced by CADAM. 
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Because it is similar, use panel ESITXXQ as a model for your 
new panel. Enter the following CMS command: 


copyfile esitxxq panel o eg3mdxl copy a 
to create your example panel file EG3MDX1 COPY. 


Use XEDIT to modify the )BODY section of the EG3MDX1 COPY 
file. Figure 105 shows the panel you should create. 


Note: Whenever you edit a file that has filetype COPY, be sure to 
type set trunc 800n the XEDIT command line. (Otherwise, 
your file will be truncated at column 72.) 


)ATTR 
_ TYPE( INPUT) INTENS(HIGH) CAPS(OFF) PAD(_) /* Mixed data input +] 
# TYPE(INPUT) INTENS(HIGH) CAPS(ON) PAD(_) /* Upper data input +f 
+ TYPE(INPUT) INTENS(HIGH) CAPS(ON) /* Mixed text input */ 
| TYPE(QUTPUT) INTENS(LOW) CAPS(OFF) SKIP(ON) /* Mixed text output */ 
$ /* Mixed text */ 


vw 


TYPE( TEXT) INTENS(LOW) CAPS (OFF 
TYPE (TEXT) INTENS(LOW) CAPS(OFF) ATTN(ON) /* PF Key pads */ 
TYPE(OUTPUT) INTENS(HIGH) CAPS(OFF) /* Message output hilighted */ 
+ TYPE(INPUT) INTENS(HIGH) CAPS (ON) /* Command line input */ 


Figure 105 (Part 1 of 3). The Example Panel for the CADAM Subtopic 


) 
) ) 

TYPE(TEXT) INTENS(HIGH) CAPS(OFF) SKIP(ON) /* Hilighted text +7 
) ATTN(ON) /* Lightpen text */ 
) 
) 


QO & 


( ( ( 

( ( ( 

( ( ( 

( ( ( ( 

TYPE(TEXT)  INTENS(LOW) CAPS(OFF) SKIP(ON 

( ( ( ( 

( ( ( ( 

( ( ( 

( ( ( 

( 
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$ MECHANICAL DESIGN - CADAM (EXAMPLE) Page 1 of l 


HF 


(Put an example of a CADAM report here.) 


$PF: 1 Help 2 fo 3 End 4 Re CUT AREA re RCI EIS IIE ie 
$PF: 7... BS ke: 9 Probrep 10 |* EXAMPLE--FOR DISPLAY ONLY * 
$ |* PRESS ENTER TO CONTINUE...* 
= Natelokohehshihetohohshihlohohehiteteloieheeieleietohile 
INIT 

&ZPRIM = NO /* This is not a primary option menu. ey 


Figure 105 (Part 2 of 3). The Example Panel for the CADAM Subtopic 
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t 


if 


7 


Pr 


BS 


/ 


nme ef 


C" 


/* Save current PF key settings. */ 


&SAVEO4 = '&ZPFO4' 
&SAVEOI = '&ZPFO9! 
&SAVE12 = '&ZPF12' 
&SAVE1L6 = '&ZPF16' 
&SAVE2Z1 = '&ZPF21' 
&SAVE24 = '&ZPF24!' 


/* Make sure the PF keys do not reference any ISPF CMD table entries.*/ 
&ZPFO4 = '...' 

&7PFO9 = '...' 

&ZPFIZ2 = '...! 

&ZPF16 = '&ZPFO4' 

&ZPF21 = '&ZPFO9' 

&ZPF24 = '&7PF12' 

VPUT (ZPFO4 ZPFO9 ZPF12 ZPF16 ZPF21 ZPF24) PROFILE 

) PROC 
a | 
/* Restore the saved PF key settings. */ 

&ZPFO4 = '&SAVEO4' 


&ZPFO9 = '&SAVEO9' 

&ZPF12 = '&SAVE12' 

&ZPF16 = '&SAVE16' 

&ZPF21 = '&SAVE21' 

&ZPF24 = '&SAVE24' 

VPUT (ZPFO4 ZPFO9 ZPF12 ZPF16 ZPF21 ZPF24) PROFILE 
) END 


Figure 105 (Part 3 of 3). The Example Panel for the CADAM Subtopic 


The parts you should change are shown highlighted. Do not 
modify any other parts of this panel, and do not add or delete any 
lines, except the copyright statement at the top of the file and the 
specification statement at the bottom of the file. The text you add 
must not include any of the following special characters: 


_#+l$ 


*¢@-7 


Chapter 8. Adding an Introduction Topic 185 


When you have finished modifying this file, enter the following 
commands on the XEDIT command line: 


set serial off 
file 


Enter the following CMS command: 


maclib rep eg2plib eg3mdx1 


to put your EG3MDX1 panel into your ISPF panel library EG2PLIB 
MACLIB. 


You have finished adding an introduction topic. 


Go to Chapter 9, “Rebuilding, Testing, and Saving Your Tailored 
Menus” on page 187. 
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(PneeaGuiate erro iad Sy AR i 4 SRR | 
Chapter 9. Rebuilding, Testing, and Saving Your Tailored Menus 


This chapter shows you how to rebuild, test, and save your tailored 
menus. 


First, you rebuild the menus on MAINT’s A minidisk. Then, you test 
the rebuilt menus to make Sure that you tailored them correctly. 
When you finish testing, you copy the menu files to the 322 and 326 
minidisks. 
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1 ts Ss i SS tS Se SS CI FE SR er eee | 
Rebuilding the Menus 


You use the PFSETUP EXEC to rebuild the menus. You rebuild the 
menus on MAINT’s A minidisk so that you will have a chance to test 
them before making them part of the system. 


To rebuild your menus, you must have read access to the 322 and 
326 minidisks. To get read access, enter the following commands: 


access 322 0/0 
access 326 n/n 


Follow these instructions to rebuild your menus: 
1. If you are using the PF menus, leave them and return to CMS. 
2. Write down the current time. 


(When you go to save your tailorings, it will be important to know 
when the PFSETUP EXEC started and when it stopped.) 


3. Enter: 
pfsetup a 
to rebuild menus onto MAINT’s A minidisk. 


4. When you see the following question: 


EG2101I Is CADAM installed? 
Answer Y, N, HELP, or QUIT. 


enter: 
y 
to include CADAM on the GRAPHICS menu. 


Note: CADAM is the application that was added in the previous 
examples. If you are adding a different application, you 
will receive a different question. 
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5. PFSETUP asks if each VM/IS package is installed. 


Answer: 


y 


to include packages that are installed, and 


n 


to exclude packages that are not installed. 


. The following message appears: 


ESA204I Creating panel definition files for modification. 


Wait for the next question. You may wait five minutes or more, 
depending on the speed of your processor and current system 
activity. 


. You are asked: 


ESA251I Do you want to tailor the VM/IS-PF user menus? 
If you answer Y, a FILELIST of the menu files will 
be displayed. The Main Menu has filename ESDLO1. 
The filename of the Introduction Menu is ESIMAA1. 
(Any changes you make will be lost the next time 
you use PFSETUP.) 
Answer Y, N, HELP, or QUIT. 


Answer: 


n 


. You are asked: 


ETU251I Do you want to tailor the VM/IS-PF System menus? 
If you answer Y, a FILELIST of the menu files will 
be displayed. The System Menu has filename ETULO1. 
(Any changes you make will be lost the next time 
you use PFSETUP.) 
Answer Y, N, HELP, or QUIT. 


Answer: 


n 
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ESA4061 


ESA4061 


9. The following messages appear: 


Panels for the environment VM/IS-Productivity Facility User Menus 
have been successfully created. 

Panels for the environment VM/IS-Productivity Facility System Menus 
have been successfully created. 


10. 


A 


i. 


(You may also see other messages.) 
Write down the current time. 


(When you go to save your tailorings, it will be important to know 
when the PFSETUP EXEC started and when it stopped.) 


Enter: 
ip! cms 
to load CMS again. 


Press ENTER when VM READ appears in the lower right corner 
of your screen. 


Note: You should always IPL CMS after executing PFSETUP. 


Enter: 
filelist * esaplib * 


If you have any files with filetyoe ESAPLIB on any minidisk, you 
must decide whether or not to erase them. (To erase them, you 
need write access to the appropriate minidisks.) Any help panels 
that are stored in xxxxxxxx ESAPLIB files will take precedence 
over help panels that are stored in the ESAPLIB MACLIB. 
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Testing Your Application and Your Help Panel 


This example starts with you logged onto MAINT and looking at the 
SYSTEM menu. To go to the SYSTEM menu, type: 


pf 


on the command line, and press ENTER. 


1. To try out the tailored GRAPHICS menu, choose panels as shown 
below: 


MAIN 
MENU 


Choose: 
Graphics 


See below 


The GRAPHICS menu should look like this: 
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V2 


ESDL250 VM/IS - GRAPHICS MENU 


To choose one of the following, type its number and press ENTER: 


1 GDDM Create two- and three-dimensional color 
charts and graphs. 
2 CADAM Work with design drawings. 
3 AS Produce Business Graphics using Application System. 


2 Short 3 End 4 Return 5 CMS 
B ~gae 9 Probrep 10 ... i ere 12 Retrieve 


Figure 106. The GRAPHICS Menu with CADAM Added 


Notice that the new entry for CADAM appears on the menu. 
2. Select CADAM, and check that the EG2CADM EXEC is invoked. 


If you created the EXEC given in the previous example, you 
should see: 


CADAM is not installed yet. 
Press Clear. 
3. Try out the Help panel. 


On the GRAPHICS menu, type 2 or cadam on the command line, 
and press PF1 (Help). 


Your Help panel (EG2CADH1) should appear. 
4. Press PF3 repeatedly, until you return to the SYSTEM menu. 
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Se eee eee 
Testing Your Introduction Topic 


This example starts with you logged onto MAINT and looking at the 
SYSTEM menu. To go to the SYSTEM menu, type: 


pf 


on the command line, and press ENTER. 


1. To try out the tailored GRAPHICS menu, choose panels as shown 
below: 


INTRODUCTION 
TOPICS 
MENU 


Choose: 


Introduction See below 


The INTRODUCTION TOPICS menu (ESIMAA10) appears. 


2. Press PF8 (Forward) to see the second page (ESIMAA11). It 
should look like this: 
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ESIMAA11 INTRODUCTION TOPICS MENU Page 2 of 2 
Choose a topic or press PF to see the first topic: 

8 Printers Printing files and working with your printer. 

9 Program Computer programming. 

10 Database Storing and retrieving data. 


11 Graphics Creating charts, graphs, and drawings. 


12 Mech-design Using Computer Graphics 


13 VMTasks Managing CMS files and system resources. 


Listing the support functions. 


— 4 Return ii a 
Backward 8 Forward 9 Probrep 10 Top oe 12 Retrieve 


Figure 107. The INTRODUCTION TOPICS menu with Mech-design Added 
Notice that the Mech-design key phrase appears in the list of 
topics. 
3. Try out the secondary menu. 


Select Mech-design. Your MECHANICAL DESIGN subtopic 
selection menu appears, as shown below: 
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nme fH 


t 


# 


c 


EG3MEC10 MECHANICAL DESIGN 


What is Mechanical Design includes 
Mechanical (Provide a general description here.) 
Design? 


Skill Level No programming experience is required for you to 
Required For the skilled programmer, 
there are .... (You may want a paragraph such as this) ... 


Available Choose from the subtopics below to find out more about 
Applications the graphic products available: 


1 CADAM Using CADAM for Computer Graphics 


Pred Se. Chae 3. End 4 Return 5 Skipback 6 Skipforw 
PF; 7 Backward 8 Forward 9 Probrep 10 ... i eee 12 Retrieve 


oe 


Figure 108. Page 1 of the MECHANICAL DESIGN Subtopic Selection menu 


4. Try out the narrative panels. 


select CADAM. The first page of the CADAM narrative appears. 
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EG3CAD1 Page 1 of 2 


(Place a description of CADAM here.) 


4 Return 5 Skipback 6 Skipforw 
Backward 8 Forward 9 Probrep 10 ... eee 12 Retrieve 


Figure 109. Page 1 of the CADAM narrative 


5. Press ENTER. The second page of the CADAM narrative 
appears. 
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EG3CAD2 


Continued... 


Examples Choose this example: 


1 Reportl An example of a CADAM report. 


Dspace ie 3. End 4 Return 5 Skipback 6 Skipforw 
PF: 7 Backward 8 Forward 9 Probrep 10 ... We pees 12 Retrieve 


Figure 110. Page 2 of the CADAM narrative 


6. Select Report1. The CADAM example panel appears. 
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EG3MDX1 MECHANICAL DESIGN - CADAM (EXAMPLE) Page 1 of 1 


(Put an example of a CADAM report here.) 


Pre ds tag meee 3. End 4 Return eae oe 
PF: 7 Backward 8 Forward 9 Probrep 10 ... 2 ee 12 Retrieve 


===> 


Figure 111. The CADAM example panel 


7. Press PF3 (End) twice. The first page of the MECHANICAL 
DESIGN subtopic selection menu appears again. 
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EG3MEC10 MECHANICAL DESIGN 


Mechanical Design includes 
Mechanical (Provide a general description here.) 
Design? 


Skill Level No programming experience is required for you to 
Required For the skilled programmer, 
(You may want a paragraph such as this) ... 


Available Choose from the subtopics below to find out more about 
Applications the graphic products available: 


1 CADAM Using CADAM for Computer Graphics 


ace 3. End 4 Return 5 Skipback 6 Skipforw 
Backward 8 Forward 9 Probrep 10 ... Lit eee 12 Retrieve 


Figure 112. Page 1 of the MECHANICAL DESIGN Subtopic Selection menu 


8. Press PF8 (Forward). The second page of the MECHANICAL 
DESIGN subtopic selection menu appears. 
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EG3MEC2 MECHANICAL DESIGN Page 2 of 2 


Try Be CADAM is available from the Graphics menu, 
or you can try it now by choosing the following: 


1 CADAM Use mechanical design. 


When you have finished, press the END key to return here. 


End of This is the end of the Mechanical Design topic. 
Topic 
Press the: 


FORWARD key to proceed to the next topic, or the 


END key to return to the Introduction Topics menu. 
PF: bd. ads 2 Hee 3. End 4 Return 5 Skipback 6 Skipforw 
PF: 7 Backward 8 Forward 9 Probrep 10 ... i weds 12 Retrieve 


Figure 113. Page 2 of the MECHANICAL DESIGN Subtopic Selection menu 


9. Select CADAM, and check that the EG2CADM EXEC is invoked. 


If you created the EXEC given in the previous example, you see: 
CADAM is not installed yet. 


Press Clear. 


10. Press PF3 repeatedly, until you return to the SYSTEM menu. 
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Saving Your Tailored Menus 


This chapter tells you how to make your tailored menus part of the 
system. 


In this example, you copy files to the 322 and 326 minidisks, and 
erase them from MAINT’s 191 minidisk. 


Getting Write Access to the 322 and 326 Minidisks 


lf you are in the PF panels, leave them and return to CMS. 


If you do not already have write access to the 322 minidisk, enter the 
following commands: 


link maint 322 322 wr 
acc 322 0 
To verify that you have write access, enter: 


q links 322 


You should see: 
MAINT 322 R/W 


If any other users are attached to this disk, ask them to detach it. 


If you do not already have write access to the 326 minidisk, enter the 
following commands: 


link maint 326 326 wr 
acc 326 n 


To verify that you have write access, enter: 


q links 326 
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You should see: 
MAINT 326 R/W 


If any other users are attached to this disk, ask them to detach it. 


Copying Source Files to the 326 Minidisk 


202 


You copy the customization files that you created to the 326 minidisk 
and erase them from MAINT’s 191 minidisk. 


Follow the instructions below for each set of files that you created. 
In this example, your application component code is EG2, and your 


online introduction component code is EG3. 


1. Go to the FILELIST screen by entering one of the following 
commands: 


e filelist eg2* * a 


e filelist eg3* * a 


2. Check the time stamp and date stamp of the files to make sure 
that they were created when you did the examples. 


3. Beside each file that you created, type: 
copyfile / = =n (replace 
4. Press ENTER. 


5. Beside each file that you copied, type: 


erase 


6. Press ENTER. 
7. Press PF3 (Quit) to leave the filelist. 
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nme mn 


ie 


8. 


Repeat these instructions for any other component code you 
used. 


Copying PFSETUP Files to the 322 Minidisk 


You copy the files that were created by PFSETUP to the 322 minidisk 
and erase them from MAINT’s 191 minidisk. 


le 


To go to the FILELIST screen, enter: 


filelist * * a 


. Check the time stamp and date stamp to see which files were 


created while PFSETUP was running. 


(These files should have filetype XEDIT, ESDESAOR, ETUESAOR, 
MACLIB, PFSETUP, or DIRFDEF.) 


. Beside each file that was created by PFSETUP, type: 


copyfile / = = 0 (replace 


_ Press ENTER. 


. Beside each file that you copied, type: 


erase 


. Press ENTER. 


. Press PF3 (Quit) to leave the filelist. 


. Enter: 
filelist * esaplib * 
. Erase all files with filetype ESAPLIB. 


. Press PF3 (Quit) to leave the filelist. 
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Appendixes 


The appendixes provide detailed explanations and technical 
descriptions, as well as serve as a reference for the following topics: 


Naming Conventions 

Files and Formats 

Calling Sequences for EXECs and MODULEs 
MACLIB Commands 

More Information about Slot Request Files. 


The detailed information provided should help you in your menu 
tailoring tasks. 
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Appendix A. Naming Conventions 


This appendix describes the naming conventions for panels, files, 
and slot requests. 


Every object you create has a name that starts with a unique 
three-character component code of your choice. When tailoring 
panels in the Productivity Facility environment, you normally choose 
two component codes for each menu tailoring package you create — 
one for your home menu changes, and one for your changes to the 
online introduction. Your chosen component code should be 
different from the first three characters of all other similar objects on 
your VM/IS system. 
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since IBM component codes do not usually contain numerals, you 
should consider including at least one numeral in your component 
code. You can also use the special characters @#$ in your 
component codes to further decrease the chances of duplicating the 
component code of any other file on your system. Table 1 shows the 
component codes for the Productivity Facility Tailoring packages. 
You never use these component codes. 


Table 1. Component Codes for the Productivity Facility Tailoring Packages 
Home Menu Introduction 
Productivity Facility Tailoring Package Component Component 
Code Code 
VM/IS BASE | ESD, ETU ESI 
pence a ESL 
Text/Office System Eor ESK 
Data Base Query ESR, ETJ ESQ, ETT 
Remote Communication Support ES! ESW 
Intelligent Workstation Support none 2 none 2 
Support Services none 2 none 2 
Transaction Processing ETV ik ETW 
Application Development System | etx r ETY 
Menu Customization ETZ, EUA none 


By using unique component codes for the objects you create, you 
can easily distinguish them from any others on the system. You also 
ensure that you do not change or override any existing menu 
tailoring packages by mistake. 


2 This package has no Productivity Facility files associated with it. 
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As well as having a name that starts with a component code, each of 


the different kinds of objects has its own specific naming 
conventions, which are described here. 
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Panel Naming Conventions 


Naming conventions for the following types of panels are discussed 
in this section: 


e Logical panels 

e Physical panels (created from logical panels) 
¢ Help panels 

e Introduction panels. 


ee ee ee PE SS BS ee SE ES ee ee eae 
Logical Panels 


The following conventions apply to logical panel names. (These are 
the names used in slot request files.) 


¢ No two logical panels can have the same name. 


e The name of a logical panel cannot be more than seven 
characters long. 


e The first three characters are the component code. 


e The fourth character must not be S or H if there isa 
corresponding Short or Help panel for this logical panel. 
Preferably, the fourth character should be L to signify the Long 
version of the panel. 


e The remaining characters must uniquely identify this panel. 
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Physical Panels (Created from Logical Panels) 
The following conventions apply to the names of physical panels 
created from logical panels using the PFSETUP exec: 


e The panel ID of a Long version panel consists of the logical panel 
ID plus one character generated by PFSETUP. 


e The panel ID of a Short version panel is the same, except that the 
fourth character is replaced by S. 


e The panel ID of a Help panel is the same, except that the fourth 
character is replaced by H. 


The final character of the panel ID is a number from 0 to 9, or a letter 
from A to Z, and is generated by PFSETUP. 


Help Panels 


The following conventions apply to the names of Help panels not 
created from logical panels. The Help panels referred to here are 
the ISPF panels of Help topics. 


e The first six characters are the same as the flow file that displays 
the Help panel. 


e The seventh character is H. 


¢ The eighth character is one of 7 to9 or A to Z. 


You can use the default Help panel ESADHLP as a model when you 
create your own. 
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Introduction Panels 


The following conventions apply to the names of online introduction 
panels not created from logical panels. 


e The first three characters are the component code. 


e The fourth and fifth characters can be used to identify the 
introduction topic to which the panel belongs. For example, PD 
may represent Program Development. 


e If the sixth character is one of A to W, it identifies a subtopic 
within a topic. If the sixth character is X, it identifies an example 
panel. 


e The seventh character is one of 7 to 9 or A to Z, and identifies the 
different panels within a subtopic, or the different example 
panels. 


e The eighth character is not usually used. You can use this 
character if the structure of your introduction topic requires 
additional identification. 


To create your own introduction topic and subtopic panels, you 
should have a good understanding of ISPF. Find an existing topic 
similar to the requirements of your new topic, and use the panels of 
that topic as models to create your own, or refer to the /nteractive 
System Productivity Facility/Program Development Facility Version 2 
Guide. 
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File Naming Conventions 


File types identify the kinds of files and the purpose the files serve. 

Table 2 describes each type of file. It gives you the common name, 
the file type, a description, and a reference page where you can find 
further information. 


File 


Package Definition 


Question/Answer 


Panel Definition 


Slot Request 
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File Type 
ESAPKG 


NLSESAQA 


ESDESAOR 


ETUESAOR 


ESASR < xxx > 


Table 2 (Page 1 of 2). File Types, Descriptions, and Cross-references 


Description 


Stores the component codes 


for a menu tailoring package. 


Stores the question that asks 
if a menu tailoring package 
should be included in the 
menus. 


A file created by the 
PFSETUP EXEC. Contains a 
list of item files that together 
define a logical panel. 


A file created by the 
PFSETUP EXEC. Contains a 
list of item files that together 
define a logical panel. This 
panel definition file is used 
for system menus. 


Contains slot requests for 
the PF menus, and the PF 
online introduction topic and 
subtopic selection menus. 
<xxx > is HM$ for the PF 
Home menus, IN$ for the PF 
online introduction topic and 
subtopic selection menus, 
and AD$ for system menus. 


Reference 


216 


218 


233 


233 


223 


Table 2 (Page 2 of 2). File Types, Descriptions, and Cross-references 


File 


Title Item File 


Content Item (group 
header) 


Content Item 
(nonselectable) 


Content Item (preface) 


Content Item (running 
header) 


Content Item (selectable) 


FILEDEF file 


Flow 


ISPF panel library 


File Type 
ESATITLE 


ESAHEAD 


ESATEXT 


ESAPREF 


ESARUNHD 


ESAITEM < x> 


DIRPDEF 


ESAFLOW 


MACLIB 


Description 


Contains title and control 
information for a logical 
panel. 


Stores a group header fora 


logical panel. 


Contains information fora 


nonselectable item ona 
logical panel. 


Contains the preface for a 


home Help menu. 


Contains running header 
information for logical 
panels. 


Stores information for a 


selectable item on a logical 
panel. <x> canbe anyofA 


10 7, 


Contains FILEDEFs for all of 


the applications ina 
particular package. ESA 


DTRFDEF contains FILEDEFs 


for the PF. 


Stores commands to display 


the panels of a narrative 


unit. The ESAFM MODULE 


controls the flow between 
these commands. 


Stores ISPF panels. Can be 


managed using the CMS 
command MACLIB. Also 


stores the message library. 


Reference 


236 


244 


244 


244 


244 


244 


254 


2090 


265 
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Slot Request Naming Conventions 


214 


The following naming conventions apply to the slot requests you 
create: 


If your slot request specifies a title item file, the name of the slot 
request must be “TITLE. 


If your slot request specifies an item file containing preface 
information, the name of your slot request must be *PREFACE. 


lf your slot request specifies an item file containing running 
header information, the name of your slot request must be 
*RUNHEAD. 


lf you are overriding an already existing slot request, you must 
give your slot request the same name as the one you are 
overriding. 


Otherwise, the name of your new slot request must start with 
your component code. 
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Files and Formats 


This section describes each of the different kinds of menu tailoring 
files. For each file, the following information is provided: 


A description of its purpose and how it should be used 
Its file naming convention 
Its record format 


The names of some files on the system that you can use as 
models when you create your own 


Examples of each particular kind of file. 
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The following kinds of files are described: 


e Package definition files 

¢ Question and answer files 
e Panel definition files 

e Slot request files 

e Item files 

e FILEDEF files 

e Flow files. 


Note: In all tailoring files, the identifiers (such as “KEY PHRASE) 
must begin in column 1, and must be in upper case. 
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Package Definition Files 


Package definition files are read by the PFSETUP EXEC to determine 
which of the menu tailoring packages to include in the menus. When 
you use the PFSETUP EXEC to rebuild the menus, it reads each 
package definition file, and executes the command specified in the 
*PACKAGE_ INSTALLED COMMAND record. Depending on the 
return code from this command, the package represented by the 
package definition file either is or is not included in the menus. If 
the package is included, the PFSETUP EXEC uses the component 
codes listed in the “COMPONENT IDS record to determine which of 
the slot request files contain the menu tailoring instructions for the 
package. 


Naming Convention 
<xxx>PKG ESAPKG 


where <xxx> is the three-character component code for the 
package. 
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Record Format: Package definition files have two record types, and 
only the first occurrence of each type is used. Each record type Is 
distinguished by an identifier, which starts in the first column and Is 
followed by a blank, and must be in upper case. The contents of 
each record start immediately following the blank. The identifiers 
and the meanings of their contents are: 


Content 


*PACKAGE_INSTALLED_ COMMAND 


*COMPONENT IDS 


<command > 


A CMS command that, when executed by the 
PFSETUP EXEC, determines whether to include this 
package in the menus. The return code from the 
command Is interpreted as follows: 


e {f the return code is O, include the package in the 
menus. 


e If the return code is 1, do not include the package 
in the menus. 


e¢ If there is any other return code, the PFSETUP 
EXEC ends. 


The recommended content for this record is EXEC 
ESAQA &01. When the ESAQA EXEC is executed, the 
file name of the package definition file replaces &01. 
The ESAQA EXEC reads the question and answer file 
< xxx > PKG NLSESAQA to display a question. 
Depending on the answer to the question, the ESAQA 
EXEC returns a return code of 0, 1, or 4. 


< list of component !Ds > 


The component codes of the slot request files for the 
package, separated by blanks. When this package its 
included in the menus, all slot request files whose file 
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names start with any of the listed component codes 
are processed. 


The PF Model: When you create your own package definition files, 
you can use ESDPKG ESAPKG as a model for the VM/IS BASE. 


The PF Example: Figure 114 shows the records from package 
definition file for the VM/IS BASE (ESDPKG ESAPKG). 


*PACKAGE INSTALLED COMMAND EXEC ESAQA &01 
*COMPONENT IDS ESD ESI ETZ 


Figure 114. The VM/IS BASE Package Definition File 
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Question and Answer Files 


A question and answer file contains a question and help text and can 
contain the answer to the question as well. These files are used to 
ask package installed questions. The question and answer files are 
processed by the ESAQA EXEC. 


For each menu tailoring package you create, you can create one 
question and answer file. The ESAQA EXEC invokes this question 
and answer file if the “PACKAGE INSTALLED COMMAND record in 
the Package Definition File contains EXEC ESAQA filename or EXEC ESAQA 
&01 where the file name or &01 are the file name of the 
corresponding question and answer file. The answer to the question 
determines whether the PFSETUP EXEC includes your package in 
the menus. 


The PFSETUP EXEC calls the ESAQA EXEC when a package 
definition file specifies that it should be called. 
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identifier 


“QUESTION 


“ANSWER 


Naming Convention 
<xXxx>PKG NLSESAQA 


where <xxx> Is the three-character component ID for the package, 
and is the same as the first three characters of the file name of the 
package definition file. 


Record Format 


<identifier> <content> 


Question and answer files have seven different record types. Each 
record type is distinguished by an identifier, which starts in the first 
column and ts followed by a blank, and must be in upper case. The 
contents of each record start immediately following the blank. A 
content of &99 may be used to represent a blank line. The identifiers 
and the meanings of their contents are: 


Content 
< question displayed to the user > 


Multiple records are allowed for this record type. All 
of the contents for these records are displayed to the 
user. 


<answer > 


Only the first occurrence of this record type is used. 
<answer> can be any valid answer to the question 
ora blank. Valid answers are defined in the *YES, 
*NO, *HELP and *QUIT records. If <answer> isa 
valid answer, the question is not displayed unless 
<answer> is as specified in the “HELP record. 
<answer> is taken as if it is the answer given by the 
user. If <answer> is a blank, the question is 
displayed and the person running the PFSETUP EXEC 
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‘HELP TEXT 


*YES 


*NO 


*HELP 


*QUIT 
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must enter a valid answer to continue with the panel 
rebuilding process. 


<heip information > 


Multiple records are allowed for this record type. 


These are the lines of text displayed when the answer 


is help, as defined in the “HELP record. 
< expected format of yes > 


lf the answer given is as specified, it is taken to be 
yes. In this case, the ESAQA EXEC ends with return 
code Q. Only the first occurrence of this record type 
is used. 


< expected format of no> 


If the answer given is as specified, it is taken to be no. 


In this case, the ESAQA EXEC ends with return code 
1. Only the first occurrence of this record type is 
used. 


<expected format of help> 


if the answer given is as specified, it is taken to be 
help. In this case, the contents of the “HELP_TEXT 
records are displayed. The contents of the 
“QUESTION records are then redisplayed. Only the 
first occurrence of this record type is used. 


<expected format of quit > 


If the answer given is as specified, it is taken to be 
quit. In this case, the ESAQA EXEC ends with return 
code 4, which terminates processing of the PFSETUP 
EXEC. Only the first occurrence of this record type Is 
used. 
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The PF Models: When you create your own question and answer 
files, you can use any of the following as models: 


¢ ESDPKG NLSESAQA (for the VM/IS BASE) 


e ESEPKG NLSESAQA (for the Engineering/Scientific Program 
Development Support package) 

° ESFPKG NLSESAQA (for the Text/Office System package) 

° ESTPKG NLSESAQA (for the Remote Communication Support 
package) 

e ESRPKG NLSESAQA (for the Data Base Query package) 

e ETVPKG NLSESAQA (for the Transaction Processing package) 

e ETXPKG NLSESAQA (for the Application Development package) 


e EUVAPKG NLSESAQA (for the tailorings done from system 
menus). 


The PF Example: Figure 115 shows the question and answer file for 
the Data Base Query package. (ESRPKG NLSESAQA). 


The following message is displayed to the user. 
The question will be repeated until the user response 
matches either *YES, *NO or *QUIT as specified below. 


*QUESTION ESR1011 Is the Data Base Query Package installed? 
*QUESTION Answer Y, N, HELP, or QUIT. 


The initial answer to the question. 
If this matches either *YES, *NO, or *QUIT as specified 


below, then the question will not be asked. 


*ANSWER 


Figure 115 (Part 1 of 2). Data Base Query Package Questien and Answer File 
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The text which appears when help is requested. 


*HELP_TEXT 
*HELP_ TEXT 
*HELP_ TEXT 
*HELP_ TEXT 
*HELP_ TEXT 
*HELP_TEXT 
*HELP_TEXT 
*HELP_TEXT 
*HELP_TEXT 
*HELP_ TEXT 
*HELP_ TEXT 
*HELP_ TEXT 
*HELP_TEXT 
*HELP_ TEXT 
*HELP_TEXT 
*HELP_ TEXT 
*HELP_ TEXT 


&99 
If you have installed the Data Base Query Package, 
then answer Y to include the home panel and 
introduction dialog entries which support this package. 
PF provides an interface to the following products in 
this package: 

Data Base Edit Facility 

Query Management Facility 

Structured Query Language/Data System 

Data Extract Facility 
&99 
If you answer N, then these entries will be omitted. 
&99 
You should not answer Y if the package is not installed, 
Since the program products which come with the package 
are required for proper execution of the dialogs. 
&99 


The tokens to be used for yes, no, quit and help. 


eT. “YY 
*NO on 
*OULT Quit 
*HELP help 


Figure 115 (Part 2 of 2). Data Base Query Package Question and Answer File 
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Slot Request Files 


These files are read by the PFSETUP EXEC to determine the tailoring 
requests. 


Each record of a slot request file is either a comment, or a request to 
include an item file in a panel definition file. As a result, the 
PFSETUP EXEC creates a panel definition file for each logical panel 
for which there is a tailoring request specified in a slot request file. 


The <panel> and <slot> fields together name a tailoring request 
on the panel. When you want to override a tailoring request, create 
a new slot request with the same <panel> and <slot> names but 
with a higher <priority>. The recommended method its to create a 
null slot request with the same <panel> and <slot> entries, but 
with a higher <priority > and then create your request with a 
different <slot>. 


When one slot request overrides another in this way, a competition 
is said to occur. The slot request with the higher priority is the 
winner, and the other slot request is the loser. The losing slot 
request is ignored, and the winning slot request is used. However, 
because there was a competition, if the winning slot request 
specified <item file 2>, then <item file 2> is used instead of 
<item file 1>. 


If both winning and losing slot requests specify item files, which, in 
turn, specify secondary logical panels in the “NEXT PANEL record, 
all slot requests for the secondary logical panel specified by the item 
file of the losing slot request are taken as additional slot requests for 
the secondary panel specified by the item file of the winning slot 
request. In other words, when a secondary menu is replaced in the 
home hierarchy, all its menu items are transferred to the new 
secondary menu. Of course, you can still explicitly override any of 
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<code> 


< priority > 


< panel > 


NO 


4 


these menu items by specifying separate slot requests with higher 
priorities. 


For more information about slot request files, see 
Appendix E, “More Information about Slot Request Files” on 
page 2/1. 


Naming Convention 


<xxx><yyyyy> ESASR<id> 


where <xxx> Is the three-character component code, <yyyyy> is 
up to five valid characters for CMS file names, and <id> is HM$ for 
the PF home menus, or IN$ for the PF introduction menus or AD§ for 
system menus. 


Record Format 


<code> <priority> <panel> <slot> <order> <item file 1> <item file 2> 
Where: 


If *, the line is treated as a comment. 

If S, it is a slot request record. 

If anything else, error message ESA101E is displayed when this 
file is processed. 


A number used to determine the sequence for an item. When 
<panel> and <slot> are the same for two different tailoring 
requests, the request with a higher priority wins the competition, 
and tne corresponding item file is used. (For example, 200 is a 
higher priority than 100.) If both tailoring requests have the 
same priority, then the one encountered first is used. 


The name of the logical panel to which the slot request applies. 
This is the name of the panel definition file to which the specified 
item file should be added. The maximum lengih of the name is 
seven characters, and the name must be a valid ISPF panel! 
name. The name is tn the format of <xxx> <y> <zzz>, where 
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< slot > 


<order > 


<item file 1> 


<item file 2> 


<xxx > is the component code, <y> is any character (except S 
or H if a Short or Help panel is requested for the logical panel), 
and <zzz> is unique within each component. For the PF home 
menus, <y> should be L (to indicate the Long version panel). 
<y> is substituted with S or H when the corresponding Short 
version and Help panels are built. When physical panels are 
built, characters from 0 to 9 and then A to Z are concatenated to 
the end of the logical panel names to construct the physical 
panel names. Thus there cannot be more than 36 pages for one 
logical panel (26 alphabetic characters and 10 numeric 
characters). 


Name of the slot being requested. 


If itis “TITLE, a title item file is referenced. Otherwise, a content 
item file is referenced. 


For the Edit a Menu panel to correctly process a preface item file 
(with filetyoe ESAPREF), the <slot> must be “PREFACE. 


The order the tailoring request is to be processed when the 
panel is built. (For example, an item whose slot request 
specified an <order> of 100 will appear on the menu before an 
item whose slot request specified an <order> of 200.) 


The file name and file type of the item file to be included in the 
specified panel definition file. 


The file name and file type of an alternative item file. This 
alternative item file is used when there is a competition (more 
than one tailoring request record requesting the same slot on 
the same panel), and this tailoring request record wins (has a 
higher priority). This field is cptional. If it is not specified, 
<item file 1> is used instead. 
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The PF Models: When you create your own slot request files, you 
can use any of the following as models: 


1. For the home menus: 


¢ ESD ESASRHMS$ (for the VM/IS BASE) 


e ESE ESASRHMS$ (for the Engineering/Scientific Program 
Development Support package) 

e ESF ESASRHMS$ (for the Text/Office System package) 

e EST ESASRHM$ (for the Remote Communication Support 
package) 

e ESR ESASRHMS$ (for the Data Base Query package) 

e ETV ESASRHMG$ (for the Transaction Processing package) 

e ETX ESASRHMSG$ (for the Application Development package). 


2. For the online introduction menus: 


e ESI ESASRINS (for the VM/IS BASE) 


e ESJ ESASRING (for the Engineering/Scientific Program 
Development Support) package 


e ESK ESASRING (for the Text/Office System package) 

e ESQ ESASRIN$ (for the Data Base Query package) 

e ESW ESASRINS (for the Remote Communications Support) 
e ETW ESASRING$ (for the Transaction Processing package) 

e ETY ESASRINS (for the Application Development package). 


3. For the System Menus 


¢ ESD ESASRADS$ (for the VM/IS BASE) 

e ESF ESASRADS$ (for the Text/Office System package) 
e ESR ESASRADS$ (for the Data Base Query package) 
e ETU ESASRADS$ (for the VM/IS BASE). 
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The PF Examples: Figure 116 and Figure 117 show the home menu 


slot request file and the introduction menu slot request file 


respectively for the VM/IS BASE. 


* <code> <priority> <panel> <slot> <order> <item 1> <item 2> 


* MAIN MENU. 
100 esd101 
100 esd101 
100 esdl01 
100 esd101 
100 esd101 
100 esd101 
100 esd101 
100 esdl101 
100 esdl01 
100 esd101 
100 esd101 
100 esd101 
100 esd101 
100 esd101 
Personal me 
100 esd119 
100 esd119 
100 esd119 
100 esd119 
100 esd119 
100 esd119 
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Figure 116 (Part 1 of 4). The Home Menu Slot Request File (ESD ESASRHMS) for the VM/IS 


BASE 


*title 
*preface 
*runhead 
esdtools 
esdperso 
esdoff 
esddocu 
esdprnt 
esdprogm 
esdgraph 
esdresou 
esdlist 
esdintro 
esdgo 
nu. 
*title 
*preface 
*runhead 
esdprim 
esdspacl 
esdcust 


000 
100 
200 
400 
500 
600 
900 
1200 
1500 
2100 
3300 
3600 
3900 
4800 


000 
100 
200 
300 
400 
500 


esd101 
esdl0lh 
esdrunhd 
esdtools 
esdperso 
esdoff 
esddocu 
esdprnt 
esdprogm 
esdgraph 
esdresou 
esdlist 
esdintro 
esdgo 


esd119 
esd119h 
esdrunhd 
esdprim 
esdspace 
esdcust 


esatitle 
esapref 

esarunhd 
esaitema 
esaitema 
esaitema 
esaitema 
esaitema 
esaitema 
esaitema 
esaitema 
esaitema 
esaitemb 
esaitema 


esatitle 
esapref 
esarunhd 
esaitema 
esahead 
esaitema 
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Figure 116 (Part 2 of 4). The Home Menu Slot Request File (ESD ESASRHMS) for the VM/IS 


Office menu. 

100 esd115 *title 
100 esdl15 *preface 
100 esdl15 *runhead 
100 esd115 esdcmsno 
Document menu. 

100 esd121 *title 
100 esdl21 *preface 
100 esd121 *runhead 
100 esdl21 esdtext 
100 esd1l21 esdfiles 
Print menu. 

100 esd124 *title 
100 esd124 *preface 
100 esd124 *runhead 
100 esd124 esdprtf 
Program menu. 

100 esd116 *title 
100 esd116 *preface 
100 esd|16 *runhead 
100 esd116 esdpedit 
Graphics menu. 

100 esd1l25 *title 
100 esd125 *preface 
100 esdl25 *runhead 
100 esd125 esdgddm 


BASE 
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000 
100 
200 
900 


000 
100 
200 
500 
600 


000 
100 
200 
700 


000 
100 
200 
300 


000 
100 
200 
300 


esd115 
esd1i5h 
esdrunhd 
esdcmsno 


esd!21 
esdl2lh 
esdrunhd 
esdtext 
esdfiles 


esd124 
esd124h 
esdrunhd 
esdprtf 


esd116 
esd11l6h 
esdrunhd 
esdpedit 


esd125 
esd125h 
esdrunhd 
esdgddm 


esatitle 
esapref 

esarunhd 
esaitema 


esatitle 
esapref 

esarunhd 
esaitema 
esaitema 


esatitle 
esapref 

esarunhd 
esaitema 


esatitle 
esapref 

esarunhd 
esaitema 


esatitle 
esapref 

esarunhd 
esaitema 


bs 
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Figure 116 (Part 3 of 4). The Home Menu Slot Request File (ESD ESASRHMS$) for the VM/IS 


Tools menu. 


100 
100 
100 
100 
100 
100 
100 
100 


100 
100 
100 
100 
100 
100 
100 
100 
110 
110 
100 
100 
100 
100 
100 
100 
100 
100 
100 


esd120 
esd120 
esd120 
esd120 
esd120 


esd120 


esd120 


esd120 


esd122 
esd122 
esd122 
esd122 
esd122 
esd122 
esd122 
esd122 
esd122 
esd122 
esd122 
esd122 
esd122 
esd122 
esd122 
esd122 
esd122 
esd122 
esd122 


*title 
*preface 
*runhead 
esdlibra 
esdnews 
esdpw 
esdprobm 


000 
100 
200 
900 
1000 
1200 
1300 


esdprobr 1400 
ALPHABETICAL LIST OF FUNCTIONS. 


*title 
*preface 
*runhead 
esdspaca 
esdspacb 
esdcmsno 
esdcust 
esdspacc 
esdpedit 
esdspacz 
esdfiles 
esdspacg 
esdgddm 
esdgo 
esdspacf 
esdintro 
esdspach 
esdlibra 
esdspaci 


BASE 


000 
100 
200 
400 
700 
800 
850 
900 
1450 
1460 
1500 
1600 
1700 
1800 
1900 
2100 
2300 
2600 
2/00 


esd120 
esd120h 
esdrunhd 
esdlibra 
esdnews 
esdpw 
esdprobm 
esdprobr 


esd122 
esd122h 
esdrunhd 
esdspace 
esdspace 
esdcmsno 
esdcust 
esdspace 
esdpedit 
esdspace 
esdfiles 
esdspace 
esdgddm 
esdgo 
esdspace 
esdintro 
esdspace 
esdlibra 
esdspace 


esatitle 
esapref 

esarunhd 
esaitema 
esaitema 
esaitema 
esaitema 
esaitema 


esatitle 
esapref 
esarunhd 
esahead 
esahead 
esaitema 
esaitema 
esahead 
esaitema 
esahead 
esaitema 
esahead 
esaitema 
esaitema 
esahead 
esaitema 
esahead 
esaitema 
esahead 
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100 
100 
100 
100 
100 
100 
100 
100 
100 
100 
100 


esd122 
esd122 
esd122 
esd122 
esd122 
esd122 
esd122 
esd122 
esd122 
esd122 
esd122 


GO PANEL. 


100 
100 
100 
100 


esdlgo 
esdlgo 
esdlgo 
esdlgo 


esdprim 
esdspacj 
esdpw 
esdprtf 
esdprobm 
esdprobr 
esdspac | 
esdspaco 
esdtext 
esdspacp 
esdresou 


*title 
*preface 
*runhead 
*header 


2800 
2850 
3300 
3500 
3600 
3700 
4200 
4700 
4800 
4900 
5500 


000 
100 
200 
300 


esdprim 
esdspace 
esdpw 
esdprtf 
esdprobm 
esdprobr 
esdspace 
esdspace 
esdtext 
esdspace 
esdresou 


esdlgo 
esdlgoh 
esdlgoh 
esdlgo 


esaitema 
esahead 
esaitema 
esaitema 
esaitemb 
esaitema 
esahead 
esahead 
esaitema 
esahead 
esaitemb 


esatitle 
esapref 
esarunhd 
esahead 


Figure 116 (Part 4 of 4). The Home Menu Slot Request File (ESD ESASRHMS) for the VM/IS 
BASE 
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* <code> <priority> <panel> 
* INTRODUCTION TOPICS MENU. 


100 
100 
100 
100 
100 
100 
100 
100 
100 
100 
100 
100 
100 
100 
100 
100 
100 
100 
100 
100 
100 
100 
100 
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esimaal 
esimaal 
esimaal 
esimaal 
esimaal 
esimaal 
esimaal 
esimaal 
esimaal 
esimaal 
esimaal 
esimaal 
esimaal 
esimaal 
esimaal 
esimaal 
es imaal 
esimaal 
esimaal 
esimaal 
esimaal 
esimaal 
esimaal 


*title 

esioview 
esispacl 
esigfacl 
esispac2 
esitools 
esispac3 
esipersn 
esispac4 
esiofice 
esispac5 
esidocum 
esispac6 
esiprint 
esispac/ 
es ipgmdp 
esispac8 
esigraph 
esispaca 
esiresou 
esispacd 
esilist 

esispace 


000 
100 
200 
300 
320 
360 
370 
460 
470 
500 
520 
600 
800 
900 
1000 
1200 
1400 
1700 
2000 
2900 
3000 
3300 
3400 


<slot> <order> <item 1> <item 2> 


esimaal 

esioview 
esispace 
esigfacl 
esispace 
esitools 
esispace 
esipersn 
esispace 
esiofice 
esispace 
esitextl 
esispace 
esiprint 
esispace 
es ipgmdp 
esispace 
esichart 
esispace 
esiresou 
esispace 
esilist 

esispace 


esatitle 
esaitema 
esahead 
esaitema 
esahead 
esaitema 
esahead 
esaitema 
esahead 
esaitema 
esahead 
esaitema 
esahead 
esaitema 
esahead 
esaitema 
esahead 
esaitema 
esahead 
esaitema 
esahead 
esaitema 
esahead 
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231 


232 


+ 


GENERAL FACILITIES MENU. 


5 100 esigeal *title 000 
Ss 100 esigeal esifcom 300 
s 100 esigeal esifgo 400 
s 100 esigeal esifmode 500 
* OFFICE MENU. 

s 100 esioffl *title 000 
s 100 esioffl esicmsnt 200 
* CMSNOTE MENU. 

s 100 esicoal *title 000 
s 100 esicoal esimsg 300 
s 100 esicoal esinote 400 
s 100 esicoal esinick 700 
* 


DOCUMENT PROCESSING MENU. 
s 100 esitxal *title 000 
s 100 esitxal esitext2 300 
* PRINT MENU. 
s 100 esiptal *title 000 
s 100 esiptal esiipfpt 100 
* PROGRAM DEVELOPMENT MENU. 


s 100 esipdal *title 000 
s 100 esipdal esiedit 400 
* GRAPHICS MENU. 

s 100 esicgal *title 000 
s 100 esicgal esigddm2 100 
s 100 esicgal esigddml 300 


Figure 117 (Part 2 of 3). The Introduction Slot Request File (ESI ESASRINS) for the VM/IS BASE 
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esigeal 
esifcom 
esifgo 
esifmode 


esioffl 
esicmsnt 


esicoal 
esimsg 

esinote 
esinick 


esitxal 
esitext2 


esiptal 
esiipfpt 


esipdal 
esiedit 


esicgal 
esigddm2 
esigddml 


esatitle 
esaitema 
esaitema 
esaitema 


esatitle 
esaitema 


esatitle 
esaitema 
esaitema 
esaitema 


esatitle 
esaitema 


esatitle 
esaitema 


esatitle 
esaitema 


esatitle 
esaitema 
esaitema 


PRPeBeermeeenePeeae® 


rm 


* TOOLS MENU. 

s 100 esitool *title 000 esitool esatitle 

s 100 esitool esilibra 200 esilibra esaitema 

s 100 esitool esiprobm 300 esiprobm esaitema 

Figure 117 (Part 3 of 3). The Introduction Slot Request File (ESI ESASRINS) for the VM/IS BASE 
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Panel Definition Files 


Panel definition files are work files created by the PFSETUP EXEC 
and the panel-driven tailoring facility. These files are constructed 
from the slot request files and contain the correct item file name and 
file type for each request. While running PFSETUP, you will be given 
the opportunity to edit these files temporarily to test changes. The 
Home and System menu panel definition files are stored on the 
output disk by the PFSETUP EXEC with file mode ending with 0. The 
Introduction dialog panel definition files are not saved. If you want 
to save these files, they should be copied to the output disk when 
you display the filelist during the running of PFSETUP EXEC. 


Naming Convention 


<panel> ESDESAOR 


for user menus, and 
<panel> ETUESAOR 


for system menus, where <panel> is the name of a logical panel 
specified in a slot request record of a slot request file. 


Record Format 


<code> <file name> <file type> <comp id> <priority> <slot name> <order> <comment> 
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Where: 


<code> 


< filename > 


< filetype > 


<comp ID> 
< priority > 

< slot name > 
<order > 


<comment > 


If the value is T, it references a title item file. Only the first T 
record in the file is used. 


If the value is I, it references a content item file. All | records are 
used. 


Records with any other <code> are ignored. 
The file name of the item file to use. 
The file type of the item file to use. 


If the item file named by <filename> and <filetype> is not 
found, the record is ignored. 


The component ID of the package which owns the entry. 
The priority from the slot request file. 

The slot name from the slot request file. 

The order from the slot request file. 


This field is provided for your information and ignored by the 
PFSETUP EXEC. 


For a code T record, it contains the panel title text. 


For a code | record that references a selectable item, it contains 
the keyword (if any) supplied by the item file. 


For other code | records, this field is blank. 


The PF Example: Figure 118 shows the panel definition file built for 
the MAIN menu (ESDLO1 ESDESAOR). The one on your system may 
be different. 
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t 


= 


ES 


Pr 


nRmRnmeneeAa BB 


HnRmOee Bf 


*MENU_CUST 


aS SSS OSS al eC 


ESDLO1 
ESDLO1H 
ESDRUNHD 
ESDTOOLS 
ESDPERSO 
ESDOFF 
ESDDOCU 
ESDPRNT 
ESDPROGM 
ESRDATAB 
ESDGRAPH 
ESDRESOU 
ESDLIST 
ESDINTRO 
ESDGO 


ESATITLE 
ESAPREF 

ESARUNHD 
ESAITEMA 
ESAITEMA 
ESAITEMA 
ESAITEMA 
ESAITEMA 
ESAITEMA 
ESATTEMA 
ESAITEMA 
ESAITEMA 
ESAITEMA 
ESATTEMB 
ESAITEMA 


ESD 
ESD 
ESD 
ESD 
ESD 
ESD 
ESD 
ESD 
ESD 
ESR 
ESD 
ESD 
ESD 
ESD 
ESD 


100 
100 
100 
100 
100 
100 
100 
100 
100 
100 
100 
100 
100 
100 
100 


*TLUEE B00 

*PREFACE 100 

*RUNHEAD 200 

ESDTOOLS 400 Tools 
ESDPERSO 500 Personal 
ESDOFF 600 Office 
ESDDOCU 900 Document 
ESDPRNT 1200 Printers 
ESDPROGM 1500 Program 
ESRDATAB 1800 Database 
ESDGRAPH 2100 Graphics 
ESDRESOU 3300 VMTasks 
ESDLIST 3600 List 


VM/IS - MAIN MENU 


ESDINTRO 3900 Introduction 


ESDGO 4800 GO 


Figure 118. The MAIN MENU Panel Definition File 


Baie alee 6 em oe a ee ee eS ee | 
Item Files 


Item files contain information that appears in the body of the panel. 
Item files are named in slot request files, and the ones used are 
listed in panel definition files. The same item file can be referenced 
by more than one slot request and can appear in more than one 
panel definition file. 


The two kinds of item files are: 


e Title item files 
¢ Content item files. 
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Title Item Files 


This kind of item file contains title and control information for a 
logical panel. 


Slot requests that refer to title item files must have a <slot> name 
of *TITLE. Panel definition file records that refer to title item files 
must have a <code> of T in column one. 


Naming Convention 
<xxx><yyyyy> ESATITLE 


where <xxx> is the three-character component code, and 
<yyyyy> is any valid character string for a CMS file name. 


Record Format 


<identifier> <content> 


Title item files have 11 different identifiers. Each record type is 
distinguished by an identifier, which starts in the first column and is 
followed by a blank, and must be in upper case. The contents of 
each record starts immediately following the blank. A content of &99 
may be used to represent a blank line. The identifiers and the 
meanings of their contents are: 


Identifier Content 


*LONG_PANEiL_INFO <skeleton name> <#of lines on panel> <page 
numbering indicator > 


Where <skeleton name> specifies the kind of logical 
panel. It must be one of the names listed below. 
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ESAXPAN (for home and system menus) 


ESIMAA1 (for the INTRODUCTION TOPICS 
selection menu) 


ESAINT (for introduction subtopic selection 
menus). 


If <skeleton name> is not specified, the default is 
ESAXPAN. 


A skeleton file name of ESAXPAN is used for home 
and system menus implemented with XEDIT. 


ESIMAA1 is used for the Introduction topic menu. 


ESAINT is used for the Introduction subtopic selection 
menus. 


Note: You can use ESAPAN for Home menus, but 


this builds an ISPF home menu, which slows 
down the transition from one menu to another. 
If you use ESAPAN and specify a 
“short_panel_ info, the short 

<skeleton name> must be ESAPANS. Also, 
if you use ESAPAN you should not put a 
selection that invokes an XEDIT menu on the 
menu. 


<# of lines on panel> is the number of detail lines 
the panel can hold. This must correspond to the 
<skeleton name> listed below. 


For the PF files: 


18 for skeleton ESAXPAN 
16 for skeleton ESIMAA1 
18 for skeleton ESAINT 

18 for skeleton ESAPAN. 
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lf <# of lines on panel> is not specified, the default 
is 18. 


<page numbering indicator > determines the kind of 
page numbering for this panel. Page numbers are 
put in the top right hand corner of each physical 
panei in the format Page nn of NN, where nn is the 
current page number and NN is the total number of 
pages for the logical panel. 


Valid entries are: 


e “PAGE (page numbers) 

¢ *“NOPAGE (no page numbers) 

e *“AUTOPAGE (page numbers only if there is more 
than one page). 


lf “AUTOPAGE is specified, and only one physical 
panel is built for a logical panel, the page number is 
not put on the panel. If *~*PAGE is requested, the page 
number appears regardless of the number of physical 
panels for this logical panel. 


If the indicator is not specified, the default is 
*“AUTOPAGE. 


<skeleton name> <#of lines on panel> <page 
numbering indicator > 


The meaning of each field is the same as described 
for “LONG PANEL _JNFO. If this record is not 
specified, the Short version panel for this logical 
panel is not built. 


Valid values of the <skeleton name> for the PF are: 
e ESAXPANS (for other home menus). 


Note: If this record is specified and ESAXPAN its 
used for the “long panel info, then EXAXPANS 


“HELP PANEL _ INFO 


must be used here. If ESAPAN was used for 


long panel info, the corresponding short 
panel skeleton name must be ESAPANS. 


Valid values for <# of lines on panel> for each PF 
<skeleton name> are: 


e 46 for skeleton ESAXPANS 
e 46 for skeleton ESAPANS. 


Valid values of the <page numbering indicator> are 
*NOPAGE, “AUTOPAGE, and “PAGE. 


lf <# of lines on panel> and <page numbering 
indicator> are not specified, the defaults are 46 and 
*AUTOPAGE respectively. 


<skeleton name> <#of lines on panel> <page 
numbering indicator > 


The meaning of each field is the same as described 
for *LONG PANEL INFO. If this record is not 
specified, the Help panel for this logical panel is not 
built. In this case, if Help is requested from the Long 
or Short version panels, a default no Help panel 
(ESADHLP) is displayed. 


The PF <skeleton name> for all PF Help menus 
should be ESAHELP. 


The <#of lines on panel> for the < skeleton 
name > ESAHELP should be 18. 


Accepted values of the <page numbering indicator > 
are “PAGE, *NOPAGE and *AUTOPAGE. 


lf <# of lines on panel> and <page numbering 
indicator> are not specified, the defaults are 18 and 
*AUTOPAGE respectively. 
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*TITLE_TEXT 


*MORE_TEXT 


*BOTTOM_TEXT 


240 
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<contents of panel title line > 


The content of this record appears at the top of the 
Long version panels and the Short version panels. 
Only the first 79 characters of the content are used. 


The number of lines should be one if the title text is to 
appear ona short panel which uses the ESAXPANS 
or ESAPANS skeleton name. 


The Edit a Menu panel will display only the first 
*TITLE_TEXT record. If you use the Edit a Menu 


panel to change the title text, the changed title is 
limited to 50 characters. 


<text to indicate more pages are to follow > 


The content of this record type appears at the bottom 
(just before the “BOTTOM_TEXT) of the Long version 
panel and the Short version panel. The content will 
not appear on the last page of the logical panel. Only 
the first 79 characters of the content are used. 


These characters will not be displayed on the Edit a 
Menu panel, so they cannot be added, changed, or 
deleted using that panel. 


<text to appear on bottom of panel > 


The content of this record type appears at the bottom 
of the Long version panel and the Short version 
panel. It appears on every page of the logical panel. 
Only the first 79 characters of the content are used. 


Note: Do not use the *~BOTTOM TEXT record in your 
item files. This record type is used by the 
MAIN menu to display the copyright statement. 


“OFFSET 


*HELP_TITLE_TEXT 


*HELP_MORE_TEXT 


*HELP_BOTTOM_TEXT 


*HELP_OFFSET 


<# of positions menu items are to be indented > 


The group headers, description lines, and selectable 
items are shifted to the right by the number of spaces 
specified. This indentation is applied to the Long 
version panels only. If this record is not specified, 
the default is three. 


< contents of Help panel title line > 


The content of this record appears at the top of the 
Help panel. Only the first 79 characters are used. 
This record is ignored if “HELP PANEL INFO is not 
specified. 


<text to indicate more pages are to follow> 


The content of this record type appears at the bottom 
of the Help panel (just before the 

“HELP _BOTTOM_TEXT) when more than one page of 
information is to be shown. The content does not 
appear on the last panel. Only the first 79 characters 
are used. This record Is ignored if 

“HELP _PANEL_INFO is not specified. 


<text to appear on bottom of panel > 


The content of this record type appears at the bottom 
of the Help panel. It shows up on every page of the 
panel. Only the first 79 characters are used. This 
record is ignored if “HELP PANEL INFO is not 
specified. 


<# of positions Help menu items are to be 
indented > 


The content of the group headers, description lines, 
and selectable items on the Help panels, are shifted 
to the right by the number of spaces specified. If not 
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specified, an offset of three is used. This record is 
ignored if “HELP PANEL _INFO is not specified. 


The PF Models: When you create your own title item files, you can 
use any of the following as models: 


For the PF home menus: 


¢ ESDLGO ESATITLE (GO menu) 
¢ ESDLO1 ESATITLE (MAIN menu) 
e ESDL15 ESATITLE (OFFICE menu) 
¢ ESDL16 ESATITLE (PROGRAM menu) 
e ESDL19 ESATITLE (PERSONAL menu) 
¢ ESDL20 ESATITLE (TOOLS menu) 
¢ ESDL21 ESATITLE (DOCUMENT menu) 
¢ ESDL22 ESATITLE ( 
FUNCTIONS menu) 
e ESDL24 ESATITLE (PRINTER menu) 
¢ ESDL25 ESATITLE (GRAPHICS menu) 
e ETULGO ESATITLE (SYSTEM GO menu) 
e ETULO1 ESATITLE (SYSTEM menu) 
e ETUL12 ESATITLE (CUSTOMIZATION menu) 
e¢ ESRL11 ESATITLE (DATABASE menu (Data Base Query)). 


ALPHABETICAL LIST OF SUPPORT 
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For the introduction topic and subtopic selection menus: 


e ESICGA1 ESATITLE (GRAPHICS menu) 

e ESICOA1 ESATITLE (OFFICE menu) 

e ESIGEA1 ESATITLE (GENERAL FACILITIES menu) 

e ESIMAA1 ESATITLE (INTRODUCTION menu) 

e ESIOFF1 ESATITLE (OFFICE menu) 

e ESIPDA1 ESATITLE (PROGRAM DEVELOPMENT menu) 

¢ ESQDQA1 ESATITLE (DATABASE menu (Data Base Query 
package)) 

e ESIPTA1 ESATITLE (PRINTERS menu) 

e ESITOO1 ESATITLE (TOOLS menu) 

e ESITXA1 ESATITLE (DOCUMENT PROCESSING menu) 

e ESWRSA1 ESATITLE (REMOTE menu). 


The PF Examples: Figure 119 shows the GRAPHICS menu title item 
file (ESDL25 ESATITLE). Figure 120 shows the title item file 
(ESICGA1 ESATITLE) for the online introduction GRAPHICS subtopic 
selection menu. 


Note: The “HELP MORE _ TEXT line was truncated at column 90 
when this book was printed. In the actual file on your system, 
this line ends “Press PF8)” like the line above. 


*LONG PANEL_INFO ESAXPAN 18 
*SHORT_PANEL_INFO ESAXPANS 46 
*HELP_PANEL_INFO ESAHELP 18 


*TITLE_TEXT VM/IS - GRAPHICS MENU 

*HELP_TITLE_TEXT VM/IS - GRAPHICS MENU: HELP 

*MORE_TEXT !| (Continued... Press PF8) 
*HELP_MORE_TEXT !| (Continued... Press 
*OFFSET 3 


*HELP_OFFSET 7 
Figure 119. The GRAPHICS menu Title Item File 
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*LONG PANEL_INFO ESAINT 18 *NOPAGE 


*TITLE_TEXT 
*TITLE_TEXT 
*TITLE_TEXT 
*ATITLE_TEXT 
*TITLE_TEXT 
*TITLE_TEXT 
*TITLE_TEXT 
*TITLE_TEXT 
*TITLE_TEXT 
*TITLE TEXT 
*TITLE TEXT 
*TITLE_TEXT 
*TITLE_TEXT 
*MORE_TEXT 

*OFFSET 13 


What is 
Graphics? 


&99 
Skill Level 
Required 


&99 
Available 


Applications 


&99 


GRAPHICS 
The graphics options provide you with online, 
interactive environments for producing color graphs, 
reports, text, and pictures. 


Page 1 of 2 


No programming experience is required for you to create, 
display, or print graphic reports. For the skilled 
programmer, there are advanced graphic facilities available 
on the system. 


Choose from the subtopics below to find out more about 
the graphic products available: 


1| (Continued... Press PF8) 


Figure 120. The Title Item File for the Introduction GRAPHICS menu 


Content Item Files 
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Each content item file contains some information to be added toa 
logical panel. For example, a content item file can contain a 
preface, a running header, a group header, a selectable menu item, 
or a nonselectable item. 


Content item files are specified in slot requests whose <slot> 
names are not *title. They appear in panel definition files following 
a <code> ofl. 


Naming Convention 


<xxx><yyyyy> <file type> 


Identifier 


where <xxx> is the three-character component code, and 
<yyyyy> is a one- to five-character string of any valid CMS file 
name characters. 


By convention, the following specific file types are used: 
¢ ESAPREF (for the preface) 
¢ ESARUNHD (for running header text) 
e ESAHEAD (for group header text) 


e ESAITEM<x> (for selectable items on the panel. <x> can 
range from A to Z, to distinguish between item files that have the 
same file name) 


* ESATEXT (for nonselectable item description text). 


Record Format 


<identifier> <content> 


Content item files have 12 different identifiers. Each record type is 
distinguished by an identifier, which starts in the first column and is 
followed by a blank, and must be in upper case. The contents of 
eacn record start immediately following the blank. A content of &99 
may be used to represent a blank line. The identifiers, and the 
meanings of their contents, are: 


Content 


*RUNNING HEADER < header record > 


This record appears where encountered as well as at 
the top cof each subsequent page. If this record is 
encountered at the bottom of a page, and there is no 
room for additional lines on that page, it is then 
moved to the top of the next page. This record 
appears on Long version panels. If a Short version 
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panel is specified, this record only appears at the top 
of a page but not where it is encountered. If 
encountered other than at the top of the page, a blank 
line is substituted for each group of consecutive 
running header records on the Short panel, and the 
running header appears at the top of subsequent 
pages. Only the first 79 characters are used. 

Multiple records are allowed. 


If the running header is to appear on a short menu, 


there should be no more than two 
“RUNNING HEADER records in an item file. 


In order for the Edit a Menu panel to correctly display 
and process *RUNNING HEADER records: 


e The item file should contain no other types of 
records other than comments and possibly 


*HELP_RUNNING HEADER records. 


e There should be only one item file that contains 
“RUNNING HEADER records per logical panel. 


e Only the first two records are displayed on the 
Edit a Menu panel. If the running header is edited 
on the Edit a Menu panel, you are limited to two 
lines of 69 characters each. 


e lf you delete or edit the running header, any other 
types of records that were in the original item file 
are not added to the new item file, which 
overrides the original. 


“HEADER TEXT < group header for description lines that follow > 


If this record is encountered, and no description text 
or selectable item follows, it is not included. If this 
record is encountered at the bottom of a page, and no 
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description text or selectable item can fit on the same 


page, it is moved to the next page. If “HEADER_TEXT 
records are found in two consecutive item files with 
no description or key phrase records found in 
between, the group of header records found in the 
first file are not used. If this is the first group of 
header records found after the “RUNNING HEADER 
or at the top of a page, leading blank header lines are 
removed. This record type appears on Long version 
panels only. When a Short panel is specified, a blank 
line is substituted for each group of consecutive 
header records. Only the first 79 characters are 
used. Multiple records are allowed. 


In order for the Edit a Menu panel to correctly display 
and process “HEADER_TEXT records: 


e There should be no other types of records in the 
same item file, other than comments and possibly 


“HELP _HEADER_TEXT records. 


e If “*HEADER_TEXT records are found in two 
consecutive item files with no description or key 
ohrase records in between, both sets of records 
will display on the Edit a Menu panel. However, 
unless items are added between the two sets, 
only the second set will be added to the rebuilt 
menu. 


e Only two lines of “HEADER_TEXT from one item 
file will be displayed on the Edit a Menu panel. If 
the item is edited, you are limited to two lines of 
51 characters each. 


e If the item is edited or deleted, any other types of 
records that were in the original item file are not 
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added to the new item file, which overrides the 
original. 


<description line for the item > 


Following the “KEY PHRASE record, the length of the 
description is equal to: 


(the length of *KEY PHRASE) + (21 - offset value) 


The *KEY PHRASE must be less than or equal to 80; 


otherwise, truncation will occur. If “KEY PHRASE is 
not specified, then 79 characters are used. 


When more than one of this record type appears in 
the same file, at least two records must fit on the 
Same page, or these records appear on the next 
page. This record type does not appear on Short 
version panels. 


< keyword for this selectable item > 


When this record type is specified, it denotes a 
selectable item. A selection number is assigned to 
the item, and the number, the keyword, and the first 
description line are put together on the same line on 
the Long version panel. Only the selection number 
and the keyword are put on the Short version panel. 
Only the first 15 characters of the first “KEY PHRASE 
record found are used. 


Notes: 


1. The following characters, as well as a blank 


character, can not be used in the *KEY PHRASE 
field: 


¢, 1s # Is ns 


2. Depending on the column width specified for the 
short GO panel, and the number of sublevels, the 


*COMMAND 


*COMMAND2 


key phrase may be truncated more than 
previously mentioned for the short GO panel. 


<command to execute if this item is selected > 


This command ts in CMS EXEC 2 format. 


This record is used only if “KEY PHRASE is specified 
in the same file. If no “COMMAND is specified, and 
the “KEY PHRASE record is specified, the command 
default is to display an error message. Only the first 
70 characters of the first record found are used. (The 
rest of the line is truncated.) 


Prior to executing the command associated with the 
*COMMAND identifier, VM/IS-Productivity Facility 
ensures that ISPF is active. If ISPF is not active, it 
will be activated by the IPF EXEC. See “FILEDEF 
Files” on page 254 for an explanation of which 
libraries receive automatic FILEDEFs. 


If your command does not require that ISPF is active, 
use *~COMMAND2 rather than *COMMAND in the item 
file. 


When editing using the Editing a Menu panel, you will 
see only up to 51 characters of the command. If you 
edit the command on that panel, all of the 
undisplayed characters (starting with the 52nd) will 
be lost. 


<command to execute if this item is selected > 


This command its similar to the command above. 
*“COMMAND2 is used to improve performance when 
ISPF is not required. 


Note: If the command is to display a home menu 
panel from another home menu panel, where 
both have a title item file with ESAXPAN 
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*PROFS_TEXT 


*HELP_RUNNING_HEADER 


250 


Taiioring Your Menus 


specified in the “LONG PANEL _INFO record, 
then the command must be ESAFLO 
<panelid>. 


<name of next panel> <*NOGO|blank> 


Where <name of next panel> specifies the name of 
the next panel (secondary menu) to display. This is 
required only if the next panel is a tailorable panel 
(panel built using the PFSETUP EXEC). If the second 
parameter is *NOGO, the selectable items on the next 
panel specified are not included on the GO menu. 
This record is ignored if an “KEY PHRASE record is 
not in the same item file. 


If you use the Edit a Menu panel to change an item 
that includes this record type, this record will not be 
carried over into the newly-created item file. 


<line of text to appear on the PROFS main menu > 


This record is not used if a “KEY PHRASE record is 
not specified or if the Text/Office System Package is 
not included. This record is required only if the item 
is to appear on the PROFS main menu. Only the first 
40 characters of the first record found are used. 


lf you use the Edit a Menu panel to change an iiem 
that includes this record type, this record will not be 
carried over into the newly-created item file. 


< header records to appear where encountered and 
on top of each subsequent page on Help panels > 


It has the same function as the *RUNNING HEADER 
records for the Long version panels. It defaults to the 


content of “RUNNING HEADER records if not 
specified. 


*HELP_HEADER_TEXT 


If you use the Edit a Menu panel to change an item 
that includes this record type, this record will not be 
carried over into the newly-created item file. 


< group header for the description lines that follow 
on the Help panels > 


It has the same function as the “HEADER TEXT 
records for the Long version panels. If this record is 
not specified in the content item file, the 

"HELP _HEADER_TEXT defaults to the content of the 
*"HEADER_TEXT records. 


If you use the Edit a Menu panel to change an item 
that includes this record type, this record will not be 
carried over into the newly-created item file. 


*HELP_ DESCRIPTION TEXT 


*HELP_KEY PHRASE 


< description line for the item on Help panels > 


It has the same function as the “DESCRIPTION TEXT 
records for the Long version panels. If this record is 


not specified in the content item file, the 
“HELP DESCRIPTION TEXT defaults to the content of 
“DESCRIPTION TEXT records. 


If you use the Edit a Menu panel to change an item 
that includes this record type, this record will not be 
carried over into the newly-created item file. 


< keyword of the selectable item on Help panels > 


It has the same function as the “KEY PHRASE record 
for the Long version panels. lf this record is not 


specified in the content item file, the 


"HELP_KEY PHRASE defaults to the content of 
*KEY PHRASE record. 
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If you use the Edit a Menu panel to change an item 
that includes this record type, this record will not be 
carried over into the newly-created item file. 


*HELP_COMMAND <command to execute if this item is selected on Help 
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panels > 
The command ts in CMS EXEC 2 format. 


It has the same function as the “COMMAND record for 
the Long version panels. This command should be a 
call to the ESAFM Module to display a narrative unit. 
It defaults to a display of a no Help panel when it is not 
specified. 


This record is ignored if no *KEY PHRASE or 
“HELP KEY PHRASE record is specified. 


If you use the Edit a Menu panel to change an item 
that includes this record type, this record will not be 
carried over into the newly-created item file. 


The PF Models: The Productivity Facility contains many content 
item files that you can use as models. The following are the content 
item files for just two menus: 


1. For the home GRAPHICS menu (ESDL25): 


¢ ESDL25 ESATITLE (title) 

¢ ESDL25H ESAPREF (preface) 

¢ ESDRUNHD ESARUNHD (running header) 

¢ ESDGDDM ESAITEMA (selectable item (GDDM)). 


2. For the online introduction GRAPHICS menu (ESICGA1): 


° ESICGA1 ESATITLE (title) 
¢ ESIGDDM1 ESAITEMA (selectable item (GDDM/PGF)) 
¢ ESIGDDM2 ESAITEMA (selectable item (GDDM)). 
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The PF Examples: Figure 121 shows the GRAPHICS menu preface 
content item file (ESDL25H ESAPREF). 


Figure 122 shows a running header content item file (ESDRUNHD 
ESARUNHD). 


Figure 123 shows a selectable item content item file (ESDGDDM 
ESAITEMA). 


*HELP DESCRIPTION TEXT 
*HELP_ DESCRIPTION TEXT 
*HELP_ DESCRIPTION TEXT 
*HELP DESCRIPTION TEXT 
*HELP_ DESCRIPTION TEXT 
*HELP_ DESCRIPTION TEXT 
*HELP DESCRIPTION TEXT 
*HELP_ DESCRIPTION TEXT 
*HELP DESCRIPTION TEXT 
*HELP DESCRIPTION TEXT 


&99 

You see a list of graphics products and functions. You 

can create bar charts, pie charts, and line diagrams with 
different sizes and types of text for titles, legends, and 
so on. You can print or store your graphics, and use a 
monochrome or color screen to display your graphics. 

&99 

Menu and data entry panels will guide you through the steps 
to produce your graphics. 

&99 


Figure 121. The Preface Content Item File for the GRAPHICS menu 


*RUNNING HEADER To choose one of the following, type its number and press ENTER: 


*RUNNING HEADER &99 

*HELP RUNNING HEADER 
*HELP RUNNING HEADER 
*HELP_RUNNING HEADER 


Help panels for each menu item follow. To read the Helps 
sequentially, press ENTER. To see a specific Help, type the 
number of the menu item on the command line and press ENTER. 


*HELP RUNNING HEADER &99 
Figure 122. The Standard Running Header Content Item File 


*DESCRIPTION TEXT Create two- and three-dimensional color 
*DESCRIPTION TEXT charts and graphs. 

*KEY PHRASE GDDM 

* @VJOPERX 11/23/87 Change ESCEXEC to EXEC 

*COMMAND EXEC ESCPRDCK ESDNOPR ESDPROD *GDDM 

* @VJOPERX 11/23/87 End 

*HELP_COMMAND ESAFM ESDGDDMA 


Figure 123. The Graphics Selectable Item Content Item File 


Appendix B. Files and Formats 253 


FILEDEF Files 


The FILEDEF command is used for any libraries that are required 
before you start ISPF. As an alternative, you can issue the ISPF 
LIBDEF command when ISPF is active. For more information on the 
FILDEF command, refer to the CMS Command and Macro Reference. 
For more information on the LIBDEF command, refer to /SPF Version 
2 for VM/SP Dialog Management Services Examples. 


FILEDEFs are done automatically if the libraries conform to the 
following naming conventions: 


<xxxx>PLIB MACLIB ( Panel library) 
<xxxx>MLIB MACLIB ( Message library) 
<xxxx>SLIB MACLIB ( Skeleton library) 
<xxxx>TLIB MACLIB ( Table library) 
<xxxx>XLIB TXTLIB ( Text library) 
<xxxx>LLIB LOADLIB ( Load library) 


where <xxxx> is a three- to four-character string of any valid CMS 
file name characters. 


FILEDEF files are used to do the FILEDEFs for all of the products ina 
package. 


Naming Convention 


<xxx><nnnnn> DIRFDEF 


where <xxx> is the three-character component code, and 
<nnnnn> are optional characters of any valid CMS file name 
characters. 


Record Format 
*COMP_IDS <xxx> <xxx> <xXXxx> ... 


<CMS executable statements> 
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where <xxx> Is the three-character environment code for which 
this file contains the FILEDEFs, and where < CMS executable 
statements > are valid CMS commands (usually FILEDEF 
commands). The <CMS executable statements > may contain calls 
to EXECs coded in the REXX language. 


The *COMP_IDS record indicates that all FILEDEFs for the specified 
component ids have been done. This overrides the automatic 
FILEDEFing of files using the correct naming convention if the file 
name starts with one of the component ids specified. 


Both record types may or may not appear in the file. Multiple 
records of the same type are allowed. 


The PF Example: Figure 124 shows the FILEDEF file for the VM/IS 
BASE. 


FILEDEF ISPPLIB DISK ISPNULL ESAPLIB * (CONCAT PERM 
FILEDEF ISPPLIB DISK ESAPLIB MACLIB * (CONCAT PERM 
FILEDEF ISPPLIB DISK ESDPLIB MACLIB * (CONCAT PERM 
FILEDEF ISPMLIB DISK ESDMLIB MACLIB * (CONCAT PERM 
FILEDEF ISPTLIB DISK ESDTLIB MACLIB * (CONCAT PERM 
COMP TDS ESA ESE ESE ESF ESK EST EDV IX 


Figure 124. The FILEDEF File for the VM/IS BASE 
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Flow Files 


Each flow file contains a list of commands used by the tailorable 
panels to display Help panels associated with a selectable item or to 
display the Help panel for the panel itself. Flow files also control the 
flow within each topic or subtopic of the PF online introduction. Each 
command in the flow file normally displays a panel. Together, the 
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commands of a flow file form a narrative unit. The ESAFM Module is 
used to control the flow between the commands of the narrative unit. 
The order that these commands appear in the flow file is the order of 
execution. 


Most of the online introduction panels and some of the Help panels 
are displayed by the ESAFM Module, using commands specified in 
flow files. 


After each command is executed, the ESAFM Module checks certain 
ISPF shared variables to determine the next command to execute. 
Each command can optionally set those variables to control the flow 
of control between commands. The ISPF shared variables are 
esaactn, esacmd, and esanum. See “ESAFM Module” on page 263 
for valid values and the meaning of each of the variables. 


A default Help flow file (ESADHLP ESAFLOW) is shipped with the 
system. This file is used whenever a Help command Is not specified 
for a panel or a selectable item on a panel. This flow file displays 
the no Help Help panel (ESADHLP). 


Naming Convention 
<xxx><nnnnn> ESAFLOW 
where <xxx> is the three-character component ID and <nnnnn> 


is an optional one- to five-character string of any valid CMS file 
name characters. 


Record Format 


<command to execute> 


This is any valid EXEC 2 executable command. lf the first nonblank 
character is an asterisk, the line is ignored. Each record can contain 
one command. 


Tailoring Your Menus 


BHREeBSeeitgstkst 8 BS 


nn 


BS 


7 


Usually, the EXEC 2 statement takes the form: 
&SUBCOMMAND ISPEXEC DISPLAY PANEL (<panel name>) 


where <panel name> is the name of the ISPF panel to be 
displayed. 


The PF Example: Figure 125 shows the flow file for the Program 
Introduction Topic: 


ESADM ESIPDA1O 
&SUBCOMMAND ISPEXEC DISPLAY PANEL(ESIPDA2) 


Figure 125. The Flow File for the Program Introduction Topic 


Note: ESADM is used in this case to display Introduction subtopic 
menus that were built using a title item file that had ESAINT 


specified as the skeleton in the “LONG PANEL INFO record. 
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Appendix C. Calling Sequences for EXECs and Modules 


This section contains the description of and the calling sequence for 
each of the following EXECs and modules: 


¢ PFSETUP 
¢ ESADM 
¢ ESAFM. 
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PFSETUP EXEC 


You use the PFSETUP EXEC to rebuild panels from information in 
package definition, question and answer, slot request, and item files. 
The following figure shows when each file is used in the panel 
building process. 


Package PFSETUP 
Definition 
Files 


Define 
Menus 
Process 


Create 


Question/ 
Answer 


Files 


Menus 
Process 


Panel 
Definition 
Files 


Item i 
Files 


Figure 126. The PFSETUP EXEC and the Panel Building Process 


The PFSETUP EXEC goes first to the package definition file. From 
the package definition file, it gets the component codes associated 
with a package. 
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It then asks the question contained in the question and answer file. 
The question looks something like this: 


EGO101I Do you want to include xxxxxxxx in the menus? 


If you answer\\, PFSETUP ignores this package. If you answer y, 
PFSETUP includes this package. 


For each included package, PFSETUP finds the slot request files 
whose filenames start with one of the component codes. The slot 
requests for each logical panel are put into a panel definition file. 
One panel definition file is built for each logical panel. 


The slot requests in the panel definition file identify the item files 
that are used for that logical panel. The key phrase and description 
text for each item are contained in an item file. Other item files 
contain text such as the title or running header. 


The relative order numbers of the slot requests determine the order 
of items on a logical panel. If there are too many items to fit on one 
panel, two or more physical panels are built for a single logical 
panel. 


The panels go into ISPF panel libraries named ESAPLIB MACLIB and 
ETUPLIB MACLIB, and XEDIT macros with the same filename as the 
panel ID. 


If you are including the Text/Office System Package (component 
code ESF) in the menus, the PFSETUP EXEC also rebuilds the 
PROFS main menus. The rebuilt PROFS menus are stored on the 
same disk as the ESAPLIB MACLIB. 


Note: If you have previously customized your PROFS menus, there 
may be multiple copies of the OFS $SYSPROF file on your system 
after the PFSETUP EXEC has been run. Verify that the correct OFS 
SSYSPROF file is accessed first and that it functions correctly. 
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Calling Format 
PFSETUP <output mode> 


where <output mode > is the disk access mode where the output 
files are to be stored. If <output mode> is blank, the 322 disk is 
updated. 


ESADM Module 
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This module displays a logical ISPF panel, which is made up of one 
or more physical panels built by the PFSETUP EXEC. 


When you create selectable item files, you can code the “COMMAND 
records to use this module to display secondary and tertiary home 
menus (built using the ESAPAN skeleton) and online introduction 
subtopic selection menus (built using the ESAINT skeleton). 


The skeleton is specified in the title item file. 


Calling Format 


ESADM <long panel> <short panel> <item number> 


where <long panel> is the name of the first Long version panel and 
<short panel> is the corresponding first Short version panel (if one 
exists) to be displayed. <item number> is the user selection 
(number or keyword)—it is optional. You should leave it blank. 
Note: If the menu was built using the ESAXPAN skeleton, use: 


*COMMAND2 ESAFLO <panel id> 


in the selectable item file that will display the menu. 
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ESAFM Module 


This module executes commands from a flow file named by the input 
parameter. This module does the following: 


1. It checks the shared variable ESANUM and sets the command to 


be executed as follows: 


e If blank, the command to be executed is the first command of 
the flow file. 


e If equal to 0, the command to be executed Is the last 
command of the flow file. 


e lf greater than the total number of commands stored tn the 
file, the module ends with a return code of 12. 


e If less than 0, the module ends with a return code of 12. 


. It sets the shared variables ESAACTN to *F, ESACMD to nulls, 


ESANUM to 1, and ESAHELP to ESAFM ESADHLP. 


. It executes the command and saves the command position in the 


variable ESANO. The command executed can set the variables 
ESAACTN, ESANUM, and ESACMD for ESAFM to determine the 
next action. 


_ If the shared variable ESACMD is not blank, it saves the value of 


the shared variables ESAACTN and ESANUM, executes the 
command stored in ESACMD, and restores the two saved 
variables. 


. It saves the shared variable ESAHELP and the PF key settings. 
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6. It checks the shared variable ESAACTN and performs one of the 
following actions, depending on the value of ESAACTN: 


Value Action 


*F Gets the command’s value (ESANO + ESANUM) from the 
flow file and executes it. ESANO stores the position of 
the command in the flow file just executed. If the 
specified record is not found, sets the shared variables 
ESAACTN to *F and ESANUM to 1, and ends the module. 


*B Gets the command’s value (ESANO - ESANUM) from the 
flow file and executes it. ESANO stores the position of 
the command in the flow file just executed. If the 
specified record ts not found, sets the shared variables 
ESAACTN to *B and ESANUM to 0, and ends the module. 


*G Gets the command’s value (ESANUM) from the flow file 
and executes it. If the specified command Is not found, 
executes the command just executed. 


*N Sets the shared variables ESAACTN to *F and ESANUM 
to 1, and ends the module. 


*p Sets the shared variables ESAACTN to *B and ESANUM 
to 1, and ends the module. 


*E Sets the shared variables ESAACTN to nulls and 
ESANUM to 1, and ends the module. 


7. It restores the shared variable ESAHELP and the PF key settings. 


Calling Format 
ESAFM <file name> 


where <file name> is the name of the flow file to be referenced. 
The file type is ESAFLOW. 
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Appendix D. MACLIB Commands 


MACLIBs are CMS macro libraries where you store your ISPF 
panels. This appendix describes commands that create and modify 
these libraries. Refer to the publications listed below for additional 
information: 


e Virtual Machine/System Product Application Development Guide 


e Virtual Machine/System Product CMS Command and Macro 
Reference 


e Interactive System Productivity Facility Version 2 for VM/SP 
Dialog Management Services. 
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Creating a New MACLIB 


The GEN parameter of the MACLIB command creates a library made 
up of the input files you specify. These files must have a file type of 
either MACRO or COPY. 


For example, if you want to create a library called MY MACLIB, 
made up of input files FILE1 COPY and FILE2 MACRO, type: 


maclib gen my filel file2 


Note: Ifa library of this name already exists, this command 
replaces it. 


Adding, Deleting, and Replacing MACLIB Members 


The files in a MACLIB are called library members. The ADD function 
adds members to an existing library. 


For example, if you want to add the file FILE3 COPY to MY MACLIB, 
type: 
maclib add my file3 


The DEL function deletes members from a MACLIB. 


To delete the file you just added to MY MACLIB, type: 
maclib del my file3 
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Notes: 


1. If a library contains two members of the same name, only the 
first member with that name is deleted. 


2. If you delete the last remaining member of a library, the entire 
library is erased. 


The REP function replaces existing members in a MACLIB. 


For example, tf you have an updated version of FILE1 COPY you 
want to put in MY MACLIB, type: 


maclib rep my filel 
Note: Whenever you edit a file that has filetype COPY, be sure to 


type set trunc 80 on the XEDIT command line. (Otherwise, 
your file will be truncated at column 72.) 
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Compressing a MACLIB 


If you issue the ADD, REP, and DEL functions repeatedly, your 
library will accumulate dead entries. These are old members that 
are no longer needed and are best cast away in the interests of 
efficiency. You can eliminate them with the COMP command. 


For example, to compress MY MACLIB, type: 


maclib comp my 
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Examining the Contents of a MACLIB 


The MAP function lists information on member name, size, and 
sequential position in a library. You can obtain this information in 
three different ways: 


e Asa file on your A-disk (the DISK option, the default) 
¢ As a file and as a spooled printer file (the PRINT option) 
¢ Asa display on your terminal (the TERM option). 


The DISK and PRINT options create a file with: 


¢ The same file name as your library 
e A file type of MAP 
e A file mode of A5 if the DISK option is specified. 


For example, if you want to obtain the information about MY MACLIB 
directly on your display, type: 


maclib map my (term 
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Three CMS commands that manipulate individual MACLIB members 
are: 


FILEDEF sets up a file definition for a member. 
PRINT prints a MACLIB member. 
TYPE displays a member on the terminal. 


You can also use the MOVEFILE command to extract a member from 
a library. 
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Extracting a MACLIB Member 


Usually, the FILEDEF and MOVEFILE commands are issued together 
to extract a member from a MACLIB. Issue the FILEDEF command 
for: 


e The member name to input the MOVEFILE command 
e The output file that is written to your A-disk. 


Suppose that you want to change FILE1 COPY in MY MACLIB. First, 
issue these two FILEDEF statements: 


filedef inmove disk my maclib (member filel 
filedef outmove disk filel copy al 


Then, type: 


movefile 


Printing and Displaying MACLIB Members 


The PRINT and TYPE commands both accept the option MEMBER as 
a means of specifying a single MACLIB member, or all the members. 


If you want to print the member FILE1 COPY from MY MACLIB, type 
the following: 


print my maclib (member filel 


If you want to display the entire MACLIB on the terminal, type the 
following: 


type my maclib (member * 
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CMS MACLIST Command to Manipulate a MACLIB 


If you want to list the members of a maclib in FILELIST, type: 


maclist my 


You can now use commands and the PF keys as you would ona 
FILELIST screen. For example, move the cursor beside a member 
and type: 


xedit 


To be sure that serial numbers are set off, on the command line, 
type: 


set serial off 


Note: Whenever you edit a panel maclib member, be sure to type 
set trunc 80 on the XEDIT command line. (Otherwise, your file 
will be truncated at column 72.) 


You can now make changes to the member and file it in the same 
way you would work with an ordinary CMS file under the XEDIT 
editor program. 


Preprocessed Panels in a MACLIB 
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The panel MACLIB macros shipped with the Productivity Facility are 
now preprocessed. Having the panels preprocessed decreases the 
time lost during panel-to-panel transition and reduces storage 
requirements. 


For more information on preprocessing the panels stored in MACLIB 
macros, see the ISPPREP command in the /nteractive System 
Productivity Facility Dialog Management Guide. 
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Appendix E. More Information about Slot Request Files 


The PFSETUP EXEC merges slot request files from different 
packages to form panel definition files for each home and on-line 
introduction menu. The two main attributes of a slot request record 
that determine whether and where it will appear are its record 
priority and panel order respectively. 


The presence of a slot request record on a menu depends on its 
priority in relation to the priorities of other records for the same 
menu and slot. The PFSETUP EXEC chooses the one with the 
highest priority for inclusion in the appropriate panel definition file. 
For example, if two records competing for the same slot have 
priorities of 100 and 110 respectively, the one with priority 110 
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appears on the menu, and the other does not appear. This situation 
is called a competition. 


The position of a slot request record on a menu depends on its panel 
order relative to the panel order of other records that the PFSETUP 
EXEC chooses for the menu. For example, if the PFSETUP EXEC has 
chosen two records with panel orders 300 and 400 respectively for 
inclusion in a panel definition file, the one with panel order 300 
appears on the menu before the one with panel order 400. 


With these principles in mind, examine the example of the merging 
of three slot request files below into the menu shown below. The 
files shown are representations of slot request files for the purpose 
of this example. 


Panel Item 
Priority | Order File 


ADJUST 


Record 
Priority 


HAMMER SLEDGE 


KNIFE BUTTER 


PK1 and PK2 compete for the HAMMER slot on the TOOLS menu. 
The priority of the PK2 record is 110 while that of the PK1 record is 
100, so the PK2 item file wins the competition. The panel orders tell 
us that a panel definition file formed by including PK1 and PK2 would 
contain SLEDGE, BUTTER, ADJUST, and HACK in that order. 
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Table 5. PK3 Slot Requests 


Record 
Priority 


PK2 and PK3 compete for the HAMMER slot on the TOOLS menu. 
The priority of the PK3 record is 120 while that of the PK2 record Is 
110, so the PK@ item file wins the competition. JACK appears 
instead of SLEDGE on the TOOLS menu if PK3 is also included in the 
panel build. 


Table 6. TOOLS MENU 


1 JACK Use a Jackhammer. 

2 BUTTER Use a butter knife. 

3 ADJUST Use an adjustable wrench. 
4 HACK Use a hacksaw. 


The information above was contained in the item files JACK, 
BUTTER, ADJUST, and HACK. 
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Summary of Changes 
for SH24-5123-03 
for VM/IS 5.1 


How to Obtain the Previous Edition of This 
Publication: 


To obtain the edition of this publication that 
pertains to VM/IS 5.0, order SQ44-5123-00. 


New Information 


¢ Part 1 of this book documents the new 
panel-driven tailoring facility. 


Changed Information 


¢ Part 2 of this book has been updated to 
reflect the panel-driven tailoring facility 
where appropriate. 


¢ The Appendixes have been updated to 
reflect changes for this release. 


Miscellaneous 


Minor technical and editorial changes have 
been made throughout this manual. 


Summary of Changes 
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